O Android 17 apresenta o modelo de notificações MetricStyle para oferecer suporte a
apps de saúde e fitness, timers e casos de uso de apps de viagem.
MetricStyle e uma atualização em tempo real para um app de relógio
Recursos
As notificações de estilo de métrica têm os seguintes recursos:
- Oferece suporte ao uso do método
setContentTitle. - Não mostra o texto de contexto.
- Oferece suporte a até três botões de ação.
- Oferece suporte à medição de até três métricas.
- Cada
Notification.Metricrequer um rótulo, um valor e uma unidade opcional. - A aparência do layout expandido varia de acordo com o número de métricas coletadas.
- Cada
MetricStyle em vários
estados. Da esquerda para a direita, tela sempre ativada (AOD), promovida como uma atualização
em tempo real, padrão/expandida e padrão/recolhida.
Comportamento
A notificação de estilo de métrica muda de comportamento com base no estado:
- As unidades de métrica são adicionadas ao final do rótulo no estado expandido.
- A segunda linha do estado recolhido mostra o conteúdo das métricas concatenado em uma única linha. A segunda e a terceira métricas só aparecem se couberem completamente quando concatenadas.
- A unidade é omitida no estado recolhido.
- Cada métrica recebe o mesmo espaço horizontal, seja qual for o conteúdo.
Como uma atualização em tempo real
Quando uma notificação de estilo de métrica é promovida para uma atualização em tempo real, considere o seguinte:
- Não é necessário fornecer
Notification.Builder#setContentTitleporque o valor da métrica é usado. Se nenhum título for fornecido, o nome do app será mostrado. - Se
Notification.Builder#setSubtextfor fornecido, ele será mostrado na linha do cabeçalho, em vez de ser movido para uma nova linha, como em outros estilos promovidos. - Os botões de ação têm o mesmo tratamento visual de pílula.
Pontos principais sobre o código
- Confira a seguir uma lista de classes relevantes e documentação de referência:
Notification.MetricStyleNotification.MetricStyle.setCriticalMetric(int)Notification.MetricNotification.Metric.FixedDateNotification.Metric.FixedFloatNotification.Metric.FixedIntNotification.Metric.FixedTextNotification.Metric.FixedTimeNotification.Metric.MetricValueNotification.Metric.TimeDifference
Consulte também
- Referência da API Notification.MetricStyle
- Referência da API Notification.Metric
- Referência da API Notification.Action