Starting in early 2025 (specific date to be announced during Q4 2024), all new watch faces published on Google Play must use the Watch Face Format. Existing watch faces that utilize other libraries, such as AndroidX or the Wearable Support Library, can continue to receive updates without transitioning to the new format.

このページは Cloud Translation API によって翻訳されました。

ウォッチフェイスの追加機能をウォッチフェイスに追加する

ウォッチフェイスの追加機能（以下、「追加機能」と表記）は、データソースからのデータを表示します。Watch Face Format を使用すると、基になるデータを取得するためのデータソースを選択できます。これにより、データを取得するコードを作成しなくても、ウォッチフェイスに時刻以外の情報を表示できます。

Watch Face Format を使用する

Complication 要素を使用すると、1 つのウォッチフェイス内で最大 8 つの追加機能を定義できます。この要素では、各ウォッチフェイスの追加機能がウォッチフェイス上のどこに表示されるかを定義することもできます。

詳しくは、GitHub の WatchFaceFormat のサンプルをご覧ください。

タイプと項目

次の表に、ComplicationData オブジェクトのタイプとフィールドを示します。ウォッチフェイスが対象の追加機能のタイプで無効な項目をリクエストすると、その項目のデフォルト値が返されます。たとえば、ウォッチフェイスが SHORT_TEXT タイプの LONG_TEXT フィールドにアクセスしようとすると、LONG_TEXT フィールドのデフォルト値である null が返されます。省略可能な項目は表示されるとは限りません。

タイプ	必須項目	省略可能項目	注
`SHORT_TEXT`	短いテキスト	アイコン焼き付き防止アイコン短いタイトルコンテンツの説明	アイコンと短いタイトルの両方を指定した場合は、いずれか 1 つのみが表示されます。
`MONOCHROMATIC_IMAGE`	モノクロ画像	焼き付き防止アイコンコンテンツの説明	テキストが不要な場合に使用します。アイコンは単色であると想定され、ウォッチフェイスによって着色される場合があります。
`RANGED_VALUE`	値最小値最大値	モノクロ画像焼き付き防止アイコン短いテキスト短いタイトル色傾斜動的な値コンテンツの説明	独自の進行状況バーを描画する場合は、`isRangedValueProgressHidden()` メソッドを使用して、`ComplicationDrawable` クラスが提供する進行状況バーを非表示にできます。
`GOAL_PROGRESS`	値目標値	モノクロ画像焼き付き防止アイコン短いテキスト短いタイトル色傾斜動的な値コンテンツの説明	GOAL_PROGRESS は、値がゼロから始まり目標値を超えてもよい歩数などを対象としています。
`LONG_TEXT`	長いテキスト	長いタイトルモノクロ画像焼き付き防止アイコン小さい画像コンテンツの説明	長いタイトルを指定した場合は、それが表示されます。
`SMALL_IMAGE`	小さい画像	コンテンツの説明	小さい画像のスタイルは、写真スタイルまたはアイコンスタイルのいずれかです。写真スタイルは、スペースを埋めることが想定され、トリミングが可能です。アイコンスタイルは、トリミングが不可能で、パディングが可能です。画像は可変であるため、焼き付き防止または低ビットの常に画面表示モードが有効なデバイスでは、常に画面表示モードでの表示に適さない画像が表示されることがあります。焼き付き防止または低ビットの常に画面表示モードが有効になっている場合、ウォッチフェイスは安全な焼き付き防止の小さい画像を使用する場合があります。それ以外の場合、画像が適切かどうかをウォッチフェイスが判断することは難しいため、画像は表示されません。
`LARGE_IMAGE`	大きい画像	コンテンツの説明	この画像は、ウォッチフェイス全体に表示できる十分な大きさがあるものです。画像は可変であるため、焼き付き防止または低ビットの常に画面表示モードが有効なデバイスでは、常に画面表示モードでの表示に適さない画像が表示されることがあります。焼き付き防止または低ビットの常に画面表示モードが有効になっている場合、画像が表示に適しているかどうかをウォッチフェイスが判断することは難しいため、常に画面表示モードで画像は表示されません。
`WEIGHTED_ELEMENTS`	要素リスト	モノクロ画像焼き付き防止アイコン短いテキスト短いタイトルコンテンツの説明	各要素は色と太さ（0 より大きい値）で構成されます。レンダリングされた要素のサイズは、その太さに比例している必要があります。太さを特定の値に合計する必要はありません。ウォッチフェイスでは WEIGHTED_ELEMENTS の色を変更できます。

次の表は、ウォッチフェイスの追加機能用スロットに送信できる空のデータ用の追加機能のタイプについて説明しています。これらのタイプには項目がないため、サポートされるタイプのリストに含める必要がありません。ウォッチフェイスは、これらのタイプから、次の 3 つのケースを判別できます。

ソースが選択されていない場合
ユーザーがスロットに「空」を選択している場合
送信するデータがソースにない場合

ソースは、更新リクエストに対して TYPE_EMPTY を送信できません。代わりに TYPE_NO_DATA を送信してください。

追加機能のタイプ	説明
`TYPE_NOT_CONFIGURED`	ウォッチフェイスの追加機能がアクティブになっているが、ユーザーがソースを選択しておらず、デフォルトも設定されていない場合に、システムによって送信されます。ソースからは送信できません。
`TYPE_EMPTY`	追加機能がアクティベートされていて、ユーザーがソースでなく「空」を選択した場合、またはウォッチフェイスがソースを選択しておらず、デフォルトとしてこの追加機能タイプが設定されている場合に、システムから送信されます。ソースからは送信できません。
`TYPE_NO_DATA`	ソースを持つウォッチフェイスの追加機能が、ソースから実際のデータを受信する前にウォッチフェイスの追加機能をクリアするためにアクティブになると、システムによって送信されます。ソースに実際の送信データがない場合は、ソースから送信できます。

ほとんどのデータソースには Watch Face Format が必要です

Wear OS の今後のリリースでウォッチフェイスの追加機能の外観を維持するには、Watch Face Format を使用する必要があります。ウォッチフェイスで Jetpack ウォッチフェイスライブラリまたはウェアラブルサポートライブラリを使用している場合、新しいバージョンの Wear OS では、ウォッチフェイスの追加機能にほとんどのデータソースのデータが表示されません。

Watch Face Format を使用しないウォッチフェイスで、追加機能の外観を完全に保持するには、ウォッチフェイスの追加機能スロットで次のいずれかのデータソースを使用する必要があります。

デバイスメーカーによっては、Watch Face Format を使用していないウォッチフェイスに、ウォッチフェイスの追加機能のソースがいくつか表示されることがあります。

あなたへのおすすめ

注: JavaScript がオフになっている場合はリンクテキストが表示されます
Wear OS でウォッチフェイスの追加機能にデータを公開する
ウォッチフェイスの追加機能
DefaultProviderPolicy