Дополнение – это любая функция, которую можно добавить на циферблат помимо времени. Например, индикатор заряда батареи – это дополнение. Complications API предназначен как для циферблатов, так и для приложений – источников данных.
В оставшейся части этого документа описываются источники данных, циферблаты и типы дополнений.
Источник данных дополнения
Приложения, которые предоставляют данные для дополнений, например об уровне заряда батареи, погоде или количестве шагов, называются источниками данных для дополнений. Эти источники данных предоставляют первичные данные и не несут ответственности за то, как их данные отображаются на циферблате. Подробнее о том, как создавать приложения, которые передают данные на циферблаты…
На следующей диаграмме показано, как Wear OS by Google опосредует поток данных от источников к циферблатам.
Дополнения на циферблатах
Циферблаты получают данные из источников данных дополнений, что позволяет им включать дополнения без необходимости в коде для получения базовых данных. Циферблаты сохраняют контроль над тем, как отображаются данные, поэтому они могут естественным образом интегрировать данные в свой дизайн. Дополнительную информацию можно найти в руководстве по дизайну дополнений.
Подробнее о том, как добавлять дополнения на циферблат…
Типы дополнений
Типы дополнений определяют, какие данные могут показываться в дополнении или предоставляться источником данных. Например, тип SHORT_TEXT используется, когда данные состоят в основном из короткой строки. Объект ComplicationData всегда имеет один тип дополнения, который определяет обязательные и необязательные поля. Обязательное поле содержит основную информацию. Название большинства типов совпадает с названием обязательного поля.
Источники данных используют типы дополнений иначе, чем циферблаты:
- Источник данных выбирает типы данных дополнений, которые будут предоставляться, включая необязательные поля этих типов, и количество поддерживаемых типов. Например, источник, который считает шаги, может поддерживать типы
RANGED_VALUEиSHORT_TEXT, а источник, который показывает следующую встречу, – типыSHORT_TEXTиLONG_TEXT. - Вы можете выбрать, сколько дополнений будет на циферблате и какие типы дополнений будут поддерживаться. Например, дополнение в виде циферблата может поддерживать типы
SHORT_TEXT,SMALL_IMAGEиRANGED_VALUE. Индикатор на циферблате может поддерживать только типRANGED_VALUE.
Подробнее о типах дополнений и поддерживаемых полях…