关于复杂功能

**复杂功能**是指除了时间之外，在手表表盘上显示的任何功能。例如，电池指示器就是一个复杂功能。复杂功能 API 适用于表盘和数据源应用。

本文档的其余部分描述了数据源、表盘和复杂功能类型。

复杂功能数据源

提供电池电量、天气或步数等数据给表盘复杂功能的应用称为复杂功能数据源。这些数据源提供原始数据，不负责控制其数据在表盘上的呈现方式。要了解如何编写向表盘提供数据的应用，请参阅向复杂功能公开数据。

下图显示了 Wear OS by Google 如何协调数据从源到表盘的流程。

表盘从复杂功能数据源接收数据，这使得它们能够包含复杂功能，而无需获取基础数据的代码。表盘保留对数据呈现方式的控制权，因此它们可以将其数据自然地与设计集成。有关更多信息，请参阅有关复杂功能的设计指南。

要了解如何在表盘中添加复杂功能，请参阅向表盘添加复杂功能。

复杂功能类型定义了可以在复杂功能中显示或由数据源提供的数据类型。例如，当数据主要由短字符串组成时，请使用SHORT_TEXT类型。一个 ComplicationData对象始终具有单个复杂功能类型，该类型定义了必填字段和可选字段。必填字段表示主要数据；大多数类型都以必填字段命名。

数据源与表盘对复杂功能类型的使用方式不同

数据源选择要提供的复杂功能数据类型，包括要提供的这些类型的哪些可选字段以及可以支持多少种不同的类型。例如，步数源可能支持RANGED_VALUE和SHORT_TEXT类型，而下一个会议源可能支持SHORT_TEXT和LONG_TEXT类型。
您可以选择在表盘中包含多少个复杂功能以及要支持的复杂功能类型。例如，表盘上的表盘复杂功能可能支持SHORT_TEXT、ICON和RANGED_VALUE类型。表盘上的仪表可能仅支持RANGED_VALUE类型。

要详细了解每种类型支持的不同复杂功能类型和字段，请参阅复杂功能类型。