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

Примечание : Эта функция доступна в версии 4 и выше приложения Watch Face Format.

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

В разделе « Работа с изображениями» уже описано, как отображать изображения на циферблате часов. Если вы хотите, чтобы пользователь мог выбирать из ряда предопределенных изображений, используйте 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 и указывает, сколько раз фотография должна стать видимой, прежде чем она будет изменена. Например, вам может показаться, что смена фотографии каждый раз, когда пользователь активирует свои часы, слишком часта. Значение по умолчанию здесь — 3.

Более подробную информацию о работе с PhotosConfiguration можно найти в примерах на GitHub.