Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Chức năng (complication) là tính năng bất kỳ xuất hiện trên mặt đồng hồ, ngoài thời gian.
Ví dụ: chỉ báo pin là một chức năng. Complications API dành cho cả ứng dụng mặt đồng hồ và ứng dụng nguồn dữ liệu.
Phần còn lại của tài liệu này mô tả nguồn dữ liệu, mặt đồng hồ và các loại chức năng.
Nguồn dữ liệu của chức năng
Các ứng dụng cung cấp dữ liệu của chức năng (chẳng hạn như mức pin, thông tin thời tiết hoặc số bước đi) cho mặt đồng hồ được gọi là nguồn dữ liệu chức năng. Những nguồn dữ liệu này cung cấp dữ liệu thô và không chịu trách nhiệm kiểm soát cách dữ liệu chức năng xuất hiện trên mặt đồng hồ.
Để tìm hiểu về cách viết ứng dụng cung cấp dữ liệu cho mặt đồng hồ, hãy xem bài viết Cung cấp dữ liệu cho chức năng.
Sơ đồ dưới đây cho thấy cách Wear OS by Google dàn xếp luồng dữ liệu từ các nguồn sang mặt đồng hồ.
Hình 1. Luồng dữ liệu của chức năng.
Chức năng trên mặt đồng hồ
Mặt đồng hồ nhận dữ liệu từ các nguồn dữ liệu chức năng, cho phép mặt đồng hồ hiển thị các chức năng mà không cần dùng mã để lấy dữ liệu cơ bản. Mặt đồng hồ duy trì quyền kiểm soát cách hiển thị dữ liệu, nhờ đó, mặt đồng hồ có thể tích hợp dữ liệu một cách tự nhiên với thiết kế của mình. Để biết thêm thông tin, hãy xem hướng dẫn thiết kế về Chức năng.
Loại chức năng sẽ xác định kiểu dữ liệu có thể xuất hiện trong một chức năng hoặc kiểu dữ liệu được một nguồn dữ liệu cung cấp. Ví dụ: sử dụng loại SHORT_TEXT khi dữ liệu chủ yếu bao gồm một chuỗi ngắn. Đối tượng ComplicationData luôn có một loại chức năng duy nhất xác định các trường bắt buộc và không bắt buộc. Trường bắt buộc đại diện cho phần dữ liệu chính; hầu hết các loại sẽ lấy tên từ trường bắt buộc.
Các nguồn dữ liệu sử dụng loại chức năng khác với mặt đồng hồ:
Một nguồn dữ liệu sẽ chọn các loại dữ liệu chức năng để cung cấp (bao gồm cả các trường không bắt buộc trong số các loại đó) và số loại dữ liệu có thể được hỗ trợ. Ví dụ: nguồn đếm bước có thể hỗ trợ loại RANGED_VALUE và SHORT_TEXT, còn nguồn cuộc họp tiếp theo có thể hỗ trợ loại SHORT_TEXT và LONG_TEXT.
Bạn có thể chọn số chức năng để đưa vào mặt đồng hồ và các loại chức năng được hỗ trợ. Ví dụ: chức năng gọi điện trên mặt đồng hồ có thể hỗ trợ các loại SHORT_TEXT, ICON và RANGED_VALUE.
Thước đo trên mặt đồng hồ có thể chỉ hỗ trợ loại RANGED_VALUE.
Để tìm hiểu thêm về các loại chức năng và trường mà từng loại hỗ trợ, hãy xem nội dung Các loại chức năng.
Nội dung và mã mẫu trên trang này phải tuân thủ các giấy phép như mô tả trong phần Giấy phép nội dung. Java và OpenJDK là nhãn hiệu hoặc nhãn hiệu đã đăng ký của Oracle và/hoặc đơn vị liên kết của Oracle.
Cập nhật lần gần đây nhất: 2025-07-27 UTC.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-07-27 UTC."],[],[],null,["# About complications\n\nA\n[complication](https://en.wikipedia.org/wiki/Complication_(horology))\nis any feature that is displayed on a watch face in addition to the time.\nFor example, a battery\nindicator is a complication. The\n[Complications API](/reference/kotlin/androidx/wear/watchface/complications/package-summary)\nis for both watch faces and data source apps.\n\n\nThe rest of this document describes data sources, watch faces, and\ncomplication types.\n\nComplication data source\n------------------------\n\nApps that provide data such as\nbattery level, weather, or step counts to watch faces for\ncomplications are called *complication data sources* . These data\nsources supply raw data\nand are not responsible for controlling how their data is rendered on a\nwatch face.\nTo learn about writing apps that provide data to watch faces, see\n[Expose data to\ncomplications](/training/wearables/exposing-data-complications).\n\nThe following diagram shows how Wear OS by Google mediates the flow of data\nfrom sources to watch faces.\n**Figure 1.** The flow of complication data.\n\nComplications on watch faces\n----------------------------\n\nWatch faces receive data from complication data sources, which lets them\ninclude\ncomplications without needing code for getting the underlying data. Watch\nfaces retain\ncontrol over how the data is rendered, so they can integrate data\nnaturally with their\ndesign. For more information, see the design guide about\n[Complications](/training/wearables/design/complications).\n\nTo learn how to add complications to a watch face, see\n[Add complications to a watch face](/training/wearables/watch-faces/adding-complications).\n\nComplication types\n------------------\n\nComplication types define what kinds of data can be shown in a\ncomplication or supplied by\na data source. For example, use the `SHORT_TEXT` type when the\ndata consists\nprimarily of a short string. A\n[`ComplicationData`](/reference/androidx/wear/watchface/complications/data/ComplicationData) object always has a single\ncomplication type that defines required and optional fields. A required\nfield\nrepresents the primary piece of data; most types take their name from\nthe required field.\n\nData sources use complication types differently from watch faces:\n\n- A data source chooses the types of complication data to supply, including which optional fields of those types to supply, and how many different types can be supported. For example, a step-count source might support the `RANGED_VALUE` and `SHORT_TEXT` types, and a next-meeting source might support the `SHORT_TEXT` and `LONG_TEXT` types.\n- You can choose how many complications to include in your watch face and the complication types to support. For example, a dial complication on a watch face might support the `SHORT_TEXT`, `ICON`, and `RANGED_VALUE` types. A gauge on the watch face might support only the `RANGED_VALUE` type.\n\nTo learn more about different complication types and fields supported by\neach type, see\n[Complication types](/training/wearables/watch-faces/adding-complications#types-fields)."]]