Chức năng
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à một thành phần giao diện người dùng trên mặt đồng hồ, chứa thông tin có thể dễ dàng xem nhanh mà người dùng muốn xem thường xuyên suốt cả ngày. Ví dụ: bạn có thể tạo một chức năng báo thông tin thời tiết hiện tại hoặc một chức năng về nhịp tim.
Nguyên tắc về trải nghiệm người dùng
Phần sau đây mô tả các nguyên tắc cần ghi nhớ khi tạo chức năng.
Xem nhanh được |
Chuyển tiếp nội dung |
Ưu tiên quyền riêng tư |
| Chức năng là các thành phần nhỏ được thiết kế nhằm giúp người dùng nhanh chóng hoàn tất các công việc thường xuyên. Hãy tạo nội dung đơn giản và dễ đọc. |
Các chức năng có giá trị nhất là khi người dùng có thể nhìn thấy nội dung cần xem chỉ với thao tác nhấc cổ tay lên mà không cần phải tương tác thêm. |
Đồng hồ đồng hành cùng người dùng ở mọi nơi. Hãy cân nhắc xem liệu nội dung trong các chức năng có phù hợp với bối cảnh của người dùng hay không. |
Trường hợp sử dụng
Khi được nhấn, các chức năng có thể giúp người dùng truy cập vào một phần cụ thể của ứng dụng. Các chức năng này cũng có thể thực hiện một thao tác độc lập. Ví dụ: khi nhấn vào chức năng Lượng nước, số ly nước đã uống sẽ thay đổi.
WearOS tự động cung cấp một chức năng lối tắt ứng dụng, vì vậy, bạn không cần phải tự tạo. Thay vào đó, hãy tập trung vào việc tạo các chức năng có thể giúp người dùng hoàn tất các nhiệm vụ tập trung.
Loại
Loại chức năng đề cập đến các loại dữ liệu xuất hiện trên chức năng hoặc do một nguồn dữ liệu cung cấp. Một chức năng luôn có loại chức năng bao gồm các trường bắt buộc và không bắt buộc. Trường bắt buộc có chứa dữ liệu chính. Hầu hết loại chức năng đều lấy tên từ trường bắt buộc. Bạn có thể chọn số chức năng sẽ đưa vào mặt đồng hồ, cũng như các loại chức năng được hỗ trợ. Có 5 loại chức năng.
| Loại |
Trường bắt buộc |
Trường không bắt buộc |
Tên lớp |
Ví dụ |
| SHORT_TEXT |
Văn bản ngắn |
Biểu tượng,
Biểu tượng bảo vệ chống pixel bị hỏng,
Tiêu đề ngắn |
ShortTextComplicationData |
 |
| ICON |
Biểu tượng |
Biểu tượng bảo vệ chống pixel bị hỏng |
MonochromaticImageComplicationData |
 |
| RANGED_VALUE |
Giá trị
Giá trị tối thiểu
Giá trị tối đa |
Biểu tượng,
Biểu tượng bảo vệ chống pixel bị hỏng,
Văn bản ngắn,
Tiêu đề ngắn |
RangedValueComplicationData |
 |
| LONG_TEXT |
Văn bản dài |
Tiêu đề dài,
Biểu tượng,
Biểu tượng bảo vệ chống pixel bị hỏng,
Hình ảnh nhỏ |
LongTextComplicationData |
 |
| SMALL_IMAGE |
Hình ảnh nhỏ |
|
SmallImageComplicationData |
 |
| LARGE_IMAGE |
Hình ảnh lớn |
|
PhotoImageComplicationData |
 |
Để biết thêm thông tin về các nguồn dữ liệu của chức năng, hãy xem phần 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.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-27 UTC."],[],[],null,["# Complications\n\nA complication is a UI element on a watch face that contains highly-glanceable\ninformation that users want to see often throughout the day. For example, you\ncould create a current weather complication, or a heart rate complication.\n\nUX Principles\n-------------\n\nThe following sections describe principles to keep in mind when creating\ncomplications.\n\n|------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------|\n| Glanceable ---------- | Content forward --------------- | Privacy first ------------- |\n| Complications are small components designed to help users complete frequent tasks quickly. Make content simple and readable. | Complications are most valuable when the content that the user needs is made visible by simply raising their wrist, without needing further interaction. | The watch travels with the user everywhere they go. Consider how the content in the complications is relevant to the user's context. |\n\nUse cases\n---------\n\nWhen tapped, complications can help users access a specific part of an app.\nThey can also perform a self-contained action. For example, tapping a\nWater Count complication changes the glass count.\n\nWearOS automatically includes an app shortcut complication, so you don't need to\ncreate your own. Instead focus on creating complications that can help users\ncomplete focused tasks.\n\nTypes\n-----\n\nComplication types refer to the kinds of data shown on the complication or\nsupplied by a data source. A complication always has a single type that includes\nrequired and optional fields. A required field contains the primary data. Most\ncomplication types take their name from their required field. You can choose how\nmany complications to include in your watch face and the complication types to\nsupport. There are five complication types.\n\n| Type | Required fields | Optional fields | Class name | Example |\n|--------------|---------------------------|--------------------------------------------------------|--------------------------------------|---------|\n| SHORT_TEXT | Short text | Icon, Burn in protection icon, Short title | `ShortTextComplicationData` | |\n| ICON | Icon | Burn in protection icon | `MonochromaticImageComplicationData` | |\n| RANGED_VALUE | Value Min value Max value | Icon, Burn in protection icon, Short text, Short title | `RangedValueComplicationData` | |\n| LONG_TEXT | Long text | Long title, Icon, Burn in protection icon, Small image | `LongTextComplicationData` | |\n| SMALL_IMAGE | Small image | | `SmallImageComplicationData` | |\n| LARGE_IMAGE | Large image | | `PhotoImageComplicationData` | |\n\nFor more information about complication data sources, see\n[Complication types](/training/wearables/watch-faces/complications#types)."]]
