创建指标样式通知

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

使用 MetricStyle 的计时器示例
图 1:时钟应用的 MetricStyle 通知模板和实时动态

功能

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

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

行为

指标样式通知会根据其状态改变行为:

  • 在展开状态下,指标单位会附加到标签中。
  • 收起状态的第二行会显示串联成一行的指标内容。只有在第二个和第三个指标串联后能完全显示时,它们才会显示。
  • 在收起状态下,单位会被省略。
  • 每个指标都会获得相同的水平空间,无论其内容如何。

实时动态形式

将指标样式通知升级为实时动态时,请注意以下事项:

代码要点

另请参阅