写真でカスタマイズする

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

ユーザーがウォッチフェイスに含める写真を選択できるようにすると、ウォッチフェイスのエクスペリエンスに個人的なタッチを加えることができます。

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

ユーザーが構成できるウォッチフェイスで画像を使用するには、<PhotosConfiguration> 要素を使用します。例:

<!-- Under WatchFace element -->
<UserConfigurations>
    <PhotosConfiguration id="photoConfig" configType="SINGLE"/>
</UserConfigurations>
watchface_photos.xml

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

1 枚の写真をサポート

単一の画像の場合、写真は次のように PartImage 要素内で使用できます。

<PartImage x="100" y="50" width="100" height="100">
    <Photos source="[CONFIGURATION.photoConfig]" defaultImageResource="default_image"/>
</PartImage>
watchface_photos.xml

コンパニオンで写真が選択されていない場合に表示される defaultImageResource は必須属性です。

別の写真を選択する場合は、コンパニオンを使用して既存の選択を別の写真に置き換える必要があります。

複数の写真のサポート

configType="MULTIPLE" で PhotosConfiguration を使用すると、ウォッチフェイスでコレクションの写真を表示できます。写真は、タップするか、一定回数表示された後に自動的に切り替えることができます。

<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 を使用するときに導入される 2 つのオプションを示しています。

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

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

  1. changeAfterEvery 属性は ON_VISIBLE 変更イベントにのみ適用され、写真が変更される前に写真が何回表示されるべきかを指定します。たとえば、ユーザーがスマートウォッチを起動するたびに写真が変わるのは頻度が高すぎると感じるかもしれません。デフォルト値は 3 です。

PhotosConfiguration の操作について詳しくは、GitHub のサンプルをご覧ください。