ウォッチフェイスの追加機能
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
ウォッチフェイスの追加機能は、ユーザーが 1 日のうちに頻繁に確認する情報をひと目でわかるように表示する UI 要素です。たとえば、現在の天気情報や心拍数を表示する追加機能を作成できます。

UX の原則
以下のセクションは、ウォッチフェイスの追加機能を作成する際に留意すべき原則です。
ひと目でわかる |
内容を先に |
プライバシー最優先 |
ウォッチフェイスの追加機能は、ユーザーが頻繁に行うタスクをさっとできるように設計された小さなコンポーネントです。シンプルで読みやすいコンテンツにしましょう。 |
ウォッチフェイスの追加機能は、ユーザーが操作しなくても、手首を上げるだけで必要なコンテンツが表示されるという点が特に便利です。 |
スマートウォッチは、外出時に常にユーザーが着用しているものです。表示されるコンテンツが、その時のユーザーの状況に適しているかどうかを考慮してください。 |
ユースケース
ユーザーがウォッチフェイスの追加機能をタップすると、アプリの特定の部分にアクセスできます。また、自己完結型のアクションを実行することもできます。たとえば、水分摂取量に関するウォッチフェイスの追加機能をタップすると、グラスの数が変化します。

Wear OS にはアプリのショートカット機能が自動的に追加されるため、独自のショートカットを作成する必要はありません。その分をデザインに注力し、ユーザーのタスクを助ける便利なウォッチフェイスの追加機能を作成できます。
タイプ
ウォッチフェイスの追加機能のタイプとは、ウォッチフェイスの追加機能で表示できるデータの種類、つまりデータソースから提供されるデータの種類を定義するものです。ウォッチフェイスの追加機能には 1 つのタイプが必ずあり、必須項目と省略可能な項目が含まれています。必須項目はデータの主な部分を表します。ほとんどのウォッチフェイスの追加機能タイプは、必須項目から名前が付けられています。ウォッチフェイスに含めるウォッチフェイスの追加機能の数と、サポートするウォッチフェイスの追加機能のタイプは選択できます。ウォッチフェイスの追加機能には 5 つのタイプがあります。
タイプ |
必須項目 |
省略可能項目 |
クラス名 |
例 |
SHORT_TEXT |
短いテキスト |
アイコン 焼き付き防止アイコン 短いタイトル |
ShortTextComplicationData |
 |
アイコン |
アイコン |
焼き付き防止アイコン |
MonochromaticImageComplicationData |
 |
RANGED_VALUE |
値 最小値 最大値 |
アイコン 焼き付き防止アイコン 短いテキスト 短いタイトル |
RangedValueComplicationData |
 |
LONG_TEXT |
長いテキスト |
長いタイトル アイコン 焼き付き防止アイコン 小さい画像 |
LongTextComplicationData |
 |
SMALL_IMAGE |
小さい画像 |
|
SmallImageComplicationData |
 |
LARGE_IMAGE |
大きい画像 |
|
PhotoImageComplicationData |
 |
ウォッチフェイスの追加機能のデータソースについて詳しくは、ウォッチフェイスの追加機能のタイプをご覧ください。
このページのコンテンツやコードサンプルは、コンテンツ ライセンスに記載のライセンスに従います。Java および OpenJDK は Oracle および関連会社の商標または登録商標です。
最終更新日 2025-07-27 UTC。
[null,null,["最終更新日 2025-07-27 UTC。"],[],[],null,["# Complications\n\nA complication is a UI element on a watch face that contains highly-glanceable\ninformation that users want to see often throughout the day. For example, you\ncould create a current weather complication, or a heart rate complication.\n\nUX Principles\n-------------\n\nThe following sections describe principles to keep in mind when creating\ncomplications.\n\n|------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------|\n| Glanceable ---------- | Content forward --------------- | Privacy first ------------- |\n| Complications are small components designed to help users complete frequent tasks quickly. Make content simple and readable. | Complications are most valuable when the content that the user needs is made visible by simply raising their wrist, without needing further interaction. | The watch travels with the user everywhere they go. Consider how the content in the complications is relevant to the user's context. |\n\nUse cases\n---------\n\nWhen tapped, complications can help users access a specific part of an app.\nThey can also perform a self-contained action. For example, tapping a\nWater Count complication changes the glass count.\n\nWearOS automatically includes an app shortcut complication, so you don't need to\ncreate your own. Instead focus on creating complications that can help users\ncomplete focused tasks.\n\nTypes\n-----\n\nComplication types refer to the kinds of data shown on the complication or\nsupplied by a data source. A complication always has a single type that includes\nrequired and optional fields. A required field contains the primary data. Most\ncomplication types take their name from their required field. You can choose how\nmany complications to include in your watch face and the complication types to\nsupport. There are five complication types.\n\n| Type | Required fields | Optional fields | Class name | Example |\n|--------------|---------------------------|--------------------------------------------------------|--------------------------------------|---------|\n| SHORT_TEXT | Short text | Icon, Burn in protection icon, Short title | `ShortTextComplicationData` | |\n| ICON | Icon | Burn in protection icon | `MonochromaticImageComplicationData` | |\n| RANGED_VALUE | Value Min value Max value | Icon, Burn in protection icon, Short text, Short title | `RangedValueComplicationData` | |\n| LONG_TEXT | Long text | Long title, Icon, Burn in protection icon, Small image | `LongTextComplicationData` | |\n| SMALL_IMAGE | Small image | | `SmallImageComplicationData` | |\n| LARGE_IMAGE | Large image | | `PhotoImageComplicationData` | |\n\nFor more information about complication data sources, see\n[Complication types](/training/wearables/watch-faces/complications#types)."]]