使用照片进行个性化设置

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