写真でカスタマイズする

注: この機能は、ウォッチフェイス フォーマットのバージョン 4 以降で利用できます。

ユーザーがウォッチフェイスに表示する写真を選択できるようにすると、ウォッチフェイスの使用感をパーソナライズできます。

ウォッチフェイスに画像を表示する方法については、画像の操作のセクションですでに説明しています。ユーザーが事前定義された一連の画像から選択できるようにするには、ユーザー構成を定義するセクションで説明されているように ListConfiguration を使用します。

ユーザーが設定できる画像をウォッチフェイスで使用する場合は、<PhotosConfiguration> 要素を使用します。次に例を示します。

<UserConfigurations>
  <PhotosConfiguration id="photoConfig" configType="SINGLE"/>
</UserConfigurations>

configType は SINGLE または MULTIPLE のいずれかです。これは、ユーザーがコンパニオン内の 1 枚の画像を選択できるか、写真のコレクションを選択できるかを指定します。

1 枚の写真をサポートする

単一画像の場合、写真は次のように 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 の使用時に導入される 2 つのオプションを示しています。

  1. change 属性を使用すると、利用可能な画像を写真で切り替えるイベントを指定できます。

上の例では、TAP と ON_VISIBLE の両方が指定されています。つまり、ユーザーが写真をタップしたとき、または写真が表示されたときに、写真が変化します。

  1. changeAfterEvery 属性は ON_VISIBLE 変更イベントにのみ適用され、写真が変更される前に写真が表示される必要がある回数を指定します。たとえば、ユーザーがスマートウォッチを起動するたびに写真を変更するのは頻度が高すぎると判断される場合があります。デフォルト値は 3 です。

PhotosConfiguration の使用方法について詳しくは、GitHub のサンプルをご覧ください。