Персонализация с помощью фотографий

Примечание. Эта функция доступна в версии 4 и более поздних версиях формата циферблата.

Пользователи могут выбирать фотографии для циферблата, чтобы персонализировать его.

В разделе работа с изображениями уже рассказывается, как показывать изображения на циферблате. Если вы хотите, чтобы пользователь мог выбирать из нескольких стандартных изображений, используйте ListConfiguration, как показано в разделе Настройка конфигураций пользователей.

Чтобы использовать на циферблате изображения, которые может настраивать пользователь, используйте элемент <PhotosConfiguration>, например:

<!-- Under WatchFace element -->
<UserConfigurations>
    <PhotosConfiguration id="photoConfig" configType="SINGLE"/>
</UserConfigurations>
watchface_photos.xml

Значение configType может быть SINGLE или MULTIPLE. Оно указывает, сможет ли пользователь выбрать одно изображение из сопутствующего баннера или коллекцию фотографий.

Поддержка одной фотографии

Если вы хотите добавить одно изображение, используйте элемент PartImage следующим образом:

<PartImage x="100" y="50" width="100" height="100">
    <Photos source="[CONFIGURATION.photoConfig]" defaultImageResource="default_image"/>
</PartImage>
watchface_photos.xml

Обратите внимание на значок defaultImageResource, который появляется, если пользователь не выбрал фотографию в приложении-компаньоне. Это обязательный атрибут.

Если пользователь хочет выбрать другую фотографию, ему нужно использовать приложение-компаньон, чтобы заменить существующую.

Поддержка нескольких фотографий

Использование PhotosConfiguration вместе с configType="MULTIPLE" позволяет отображать на циферблате фотографию из коллекции, которая может меняться при нажатии или автоматически после определенного количества просмотров.

<PartImage x="100" y="250" width="100" height="100">
    <Photos change="ON_VISIBLE TAP" changeAfterEvery="5"
        source="[CONFIGURATION.galleryConfig]" defaultImageResource="default_image"/>
</PartImage>
watchface_photos_multi.xml

В приведенном выше примере показаны два варианта, которые появляются при использовании MULTIPLE:

1. Атрибут change позволяет разработчику указать, какие события должны вызывать смену изображений.

В приведенном выше примере указаны оба значения: TAP и ON_VISIBLE. Это означает, что фотография меняется в ответ либо на нажатие пользователя, либо на то, что фотография становится видимой.

1. Атрибут changeAfterEvery применяется только к событию ON_VISIBLE change и указывает, сколько раз фотография должна была стать видимой до того, как она будет изменена. Например, вы можете посчитать, что смена фотографии каждый раз, когда пользователь включает часы, происходит слишком часто. Значение по умолчанию – 3.

Подробнее о работе с PhotosConfiguration можно узнать из примеров на GitHub.