Android 17 では、健康&フィットネス アプリ、タイマー、旅行アプリのユースケースをサポートする MetricStyle 通知テンプレートが導入されています。
MetricStyle 通知テンプレートとライブ情報
機能
指標スタイルの通知には次の機能があります。
setContentTitleメソッドの使用をサポートします。- コンテキスト テキストは表示されません。
- 最大 3 つのアクション ボタンをサポートします。
- 最大 3 つの指標の測定をサポートします。
- 各
Notification.Metricには、ラベル、値、オプションの単位が必要です。 - 展開されたレイアウトの外観は、取得された指標の数によって異なります。
- 各
MetricStyle テンプレートの例。左から、常に表示状態のディスプレイ(AOD)、ライブ情報としてプロモート、デフォルト / 展開、デフォルト / 折りたたみ。動作
指標スタイルの通知は、状態に応じて動作が変化します。
- 展開された状態では、指標の単位がラベルに追加されます。
- 折りたたまれた状態の 2 行目には、指標の内容が 1 行に連結されて表示されます。2 番目と 3 番目の指標は、連結したときに完全に収まる場合にのみ表示されます。
- 折りたたまれた状態では、単位は省略されます。
- 各指標は、コンテンツに関係なく、同じ水平方向のスペースを受け取ります。
ライブ情報として
指標スタイルの通知がライブ情報にプロモートされる場合は、次の点に注意してください。
- 代わりに指標値が使用されるため、
Notification.Builder#setContentTitleを指定する必要はありません。タイトルが指定されていない場合は、アプリ名が表示されます。 Notification.Builder#setSubtextが指定されている場合、他のプロモート スタイルとは異なり、新しい行に移動されるのではなく、ヘッダー行に表示されます。- 操作ボタンは、同じピル型の視覚処理が施されています。
コードに関する主なポイント
- 関連するクラスとリファレンス ドキュメントの一覧を以下に示します。
Notification.MetricStyleNotification.MetricStyle.setCriticalMetric(int)Notification.MetricNotification.Metric.FixedDateNotification.Metric.FixedFloatNotification.Metric.FixedIntNotification.Metric.FixedTextNotification.Metric.FixedTimeNotification.Metric.MetricValueNotification.Metric.TimeDifference