指標スタイルの通知を作成する

Android 17 では、健康とフィットネスのアプリ、タイマー、旅行アプリのユースケースをサポートするための MetricStyle 通知テンプレートが導入されています。

MetricStyle を使用したタイマーの例
図 1: 時計アプリの MetricStyle 通知テンプレートとライブ アップデート

機能

指標スタイルの通知には、次の機能があります。

  • setContentTitle メソッドの使用をサポートします。
  • コンテキスト テキストが表示されない。
  • 最大 3 つのアクション ボタンをサポートします。
  • 最大 3 つの指標の測定をサポートします。
    • 各 Notification.Metric には、ラベル、値、単位（省略可）が必要です。
    • 展開されたレイアウトの表示は、取得された指標の数によって異なります。
さまざまな状態の MetricStyle テンプレート
図 2: さまざまな状態の MetricStyle テンプレートの例。左から右に、常時オンのディスプレイ（AOD）、ライブ アップデートとしてプロモーションされたもの、デフォルト/展開、デフォルト/折りたたみ。

動作

指標スタイルの通知は、状態に応じて動作が変化します。

  • 展開された状態では、ラベルに単位が追加されます。
  • 折りたたまれた状態の 2 行目には、1 行に連結された指標の内容が表示されます。2 つ目と 3 つ目の指標は、連結したときに完全に収まる場合にのみ表示されます。
  • 折りたたみ状態では単位は省略されます。
  • 各指標には、コンテンツに関係なく、同じ水平方向のスペースが割り当てられます。

ライブ情報として

指標スタイルの通知がライブ更新に昇格される場合は、次の点を考慮してください。

  • 指標値が代わりに使用されるため、Notification.Builder#setContentTitle を指定する必要はありません。タイトルが指定されていない場合は、アプリ名が表示されます。
  • Notification.Builder#setSubtext が指定されている場合、他の昇格スタイルとは異なり、新しい行に移動されず、ヘッダー行に表示されます。
  • アクション ボタンには同じピル型のビジュアル処理が施されています。

コードに関する主なポイント

関連ドキュメント