使用照片进行个性化设置

注意：此功能适用于表盘格式版本 4 及更高版本。

允许用户选择要添加到表盘的照片，有助于为表盘体验增添个性化色彩。

使用图片部分已经介绍了如何在表盘中显示图片。如果您想允许用户从一系列预定义图片中进行选择，请使用 ListConfiguration，如定义用户配置部分所示。

如需在表盘中使用用户可配置的图片，请使用 <PhotosConfiguration> 元素，例如：

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

configType 可以是 SINGLE 或 MULTIPLE，用于指明用户是否能够选择随播广告中的单张图片或照片集。

支持单张照片

对于单张图片，可以在 PartImage 元素中使用照片，如下所示：

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

请注意 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>

上面的示例展示了使用 MULTIPLE 时引入的两个选项：

  1. change 属性允许开发者指定哪些事件应导致照片在可用图片之间循环。

在前面的示例中，TAP 和 ON_VISIBLE 均已指定，这意味着 照片会根据用户点按照片或 照片变为可见状态而发生变化。

  1. changeAfterEvery 属性仅适用于 ON_VISIBLE 更改事件，用于指定在照片更改之前，照片应显示多少次。例如，您可能会觉得每次用户唤醒手表时都更换照片过于频繁。此处的默认值为 3。

如需详细了解如何使用 PhotosConfiguration，请参阅 GitHub 上的示例。