使用照片进行个性化设置

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