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

Примечание : эта функция доступна в формате циферблата версии 4 и выше.

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

Раздел «Работа с изображениями» уже охватывает, как отображать изображения на циферблате. Если вы хотите разрешить пользователю выбирать из ряда предопределенных изображений, используйте ListConfiguration , как показано в разделе «Определение пользовательских конфигураций» .

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

<UserConfigurations>
  <PhotosConfiguration id="photoConfig" configType="SINGLE"/>
</UserConfigurations>

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

Поддержите одну фотографию

В случае с одним изображением фотографию можно использовать в элементе PartImage следующим образом:

<PartImage ...>
  <Photos source="[CONFIGURATION.photoConfig]" defaultImageResource="default_image"/>
</PartImage>

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

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

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

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

<Photos change="ON_VISIBLE TAP" changeAfterEvery="5"
    source="[CONFIGURATION.photoConfig]" defaultImageResource="default_image"/>

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

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

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

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

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