使用相片打造個人化設定

注意：這項功能適用於 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 上的範例。