使用照片进行个性化设置

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

允许用户选择要包含在表盘主题中的照片，有助于为表盘主题体验增添个性化色彩。

使用图片部分已介绍如何在表盘中显示图片。如果您想允许用户从一系列预定义图片中进行选择，请使用 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 上的示例。