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

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 が指定されている場合、他のプロモート スタイルとは異なり、新しい行に移動されるのではなく、ヘッダー行に表示されます。
  • 操作ボタンは、同じピル型の視覚処理が施されています。

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

関連情報