Android 17 引入了 MetricStyle 通知模板,可支持健康与健身应用、计时器和旅行应用等应用场景。
MetricStyle 通知模板和实时动态
功能
指标样式通知具有以下功能:
- 支持使用
setContentTitle方法。 - 不显示上下文文本。
- 最多支持 3 个操作按钮。
- 支持衡量最多 3 项指标。
- 每个
Notification.Metric都需要一个标签、值和可选单位。 - 展开式布局的外观因所采用的指标数量而异。
- 每个
MetricStyle 模板示例。从左到右依次为:熄屏显示 (AOD)、作为实时动态进行宣传、默认/展开和默认/收起。
行为
指标样式通知会根据其状态改变行为:
- 在展开状态下,指标单位会附加到标签中。
- 收起状态的第二行会显示串联成一行的指标内容。只有在第二个和第三个指标串联后能完全显示时,它们才会显示。
- 在收起状态下,单位会被省略。
- 每个指标都会获得相同的水平空间,无论其内容如何。
实时动态形式
将指标样式通知升级为实时动态时,请注意以下事项:
- 无需提供
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