复杂功能是指在表盘上除了时间之外显示的任何功能。例如,电量指示器就是一种复杂功能。复杂功能 API 适用于表盘和数据源应用。
本文档的其余部分将介绍数据源、表盘和复杂功能类型。
复杂功能数据源
将电池电量、天气或步数等数据提供给表盘的复杂功能的应用称为复杂功能数据源。这些数据源提供原始数据,不负责控制数据在表盘上的呈现方式。要了解如何编写向表盘提供数据的应用,请参阅将数据公开到复杂功能。
下图展示了 Google 的 Wear OS 如何协调数据从源流向表盘。

表盘上的复杂功能
表盘从复杂功能数据源接收数据,这使得它们无需获取底层数据的代码即可包含复杂功能。表盘保留了对数据呈现方式的控制权,因此可以将其数据与设计自然地融合。有关更多信息,请参阅复杂功能的设计指南。
要了解如何向表盘添加复杂功能,请参阅向表盘添加复杂功能。
复杂功能类型
复杂功能类型定义了可以在复杂功能中显示或由数据源提供的何种数据。例如,当数据主要由短字符串组成时,请使用 SHORT_TEXT
类型。 ComplicationData
对象始终具有一个单一的复杂功能类型,该类型定义了必需字段和可选字段。必需字段表示主要数据;大多数类型都以必需字段命名。
数据源使用复杂功能类型的方式与表盘不同
- 数据源选择要提供的复杂功能数据类型,包括要提供这些类型的哪些可选字段,以及可以支持多少种不同类型。例如,步数源可能支持
RANGED_VALUE
和SHORT_TEXT
类型,而下一次会议源可能支持SHORT_TEXT
和LONG_TEXT
类型。 - 您可以选择在表盘中包含多少复杂功能以及支持的复杂功能类型。例如,表盘上的圆形复杂功能可能支持
SHORT_TEXT
、ICON
和RANGED_VALUE
类型。表盘上的仪表可能只支持RANGED_VALUE
类型。
要了解不同复杂功能类型以及每种类型支持的字段,请参阅复杂功能类型。