创建指标样式通知

Android 17 引入了 MetricStyle 通知模板，可支持健康与健身应用、计时器和旅行应用等应用场景。

使用 MetricStyle 的计时器示例
图 1：时钟应用的 MetricStyle 通知模板和实时更新

功能

指标样式通知具有以下功能：

  • 支持使用 setContentTitle 方法。
  • 不显示上下文文本。
  • 最多支持 3 个操作按钮。
  • 支持衡量最多 3 项指标。
    • 每个 Notification.Metric 都需要一个标签、一个值和一个可选的单位。
    • 展开布局的外观因所采用的指标数量而异。
处于各种状态的 MetricStyle 模板
图 2：处于各种状态的 MetricStyle 模板示例。从左到右依次为：始终保持开启状态的显示屏 (AOD)（宣传为实时更新）、默认/展开状态和默认/收起状态。

行为

指标样式通知会根据其状态更改行为：

  • 在展开状态下，指标单位会附加到标签中。
  • 折叠状态的第二行显示了串联成一行的指标内容。只有当第二个和第三个指标在串联后能够完全显示时，才会显示这两个指标。
  • 在折叠状态下，系统会省略单位。
  • 无论指标的内容如何，每个指标都会获得相同的水平空间。

以实时更新的形式

当指标样式通知升级为实时动态时，请注意以下事项：

代码要点

另请参阅