使用照片个性化

注意: 此功能适用于表盘格式版本 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 上的示例。