使用相片打造個人化設定

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