Criar uma notificação com foco no progresso

notificação principal com foco no progresso da aba superior
Figura 1. Uma notificação focada no progresso na parte de cima da aba.

O Android 16 apresenta um novo modelo de notificação para ajudar os usuários a acompanhar jornadas de ponta a ponta iniciadas pelo usuário. Essas notificações terão visibilidade melhorada nas interfaces do sistema e classificação superior na gaveta de notificações.

Use Notification.ProgressStyle para estilizar notificações centradas no progresso. Os principais casos de uso incluem carona compartilhada, entrega e navegação. Nessa classe, você vai encontrar a capacidade de denotar estados e marcos em uma jornada do usuário usando pontos e segmentos.

Classes relevantes

As classes a seguir contêm as diferentes APIs usadas para construir uma notificação ProgressStyle:

Anatomia e personalização

As imagens a seguir mostram as diferentes partes que compõem as notificações do ProgressStyle:

Figura 2.

A. Cabeçalho: subtexto

Notification.Builder#setSubText()

B. Cabeçalho: hora

Notification.Builder#setWhen()

C. Título do conteúdo

Notification.Builder#setContentTitle()

D. Texto do conteúdo

Notification.Builder#setContentText()

E. Barra de progresso

Notification.ProgressStyle

F. Botão de ação

Notification.Builder#addAction()
Figura 3. Os apps podem definir uma imagem de veículo para o ícone do rastreador e usar segmentos e pontos para indicar a experiência e os marcos importantes do transporte por aplicativo.

Configurar

Use as APIs certas e siga as práticas recomendadas para oferecer a melhor experiência do usuário com atualizações de progresso.

  • Defina os campos certos para atender à visibilidade promovida.
  • Use os elementos visuais certos para orientar os usuários. Por exemplo, apps de carona compartilhada precisam definir uma imagem do veículo e usar a cor mais precisa dele na notificação usando Notification#setLargeIcon.
  • Use uma linguagem concisa e clara para definir o progresso da jornada do usuário. O horário de chegada, o nome do motorista e o estado da viagem são textos importantes que a notificação precisa comunicar.
  • Ofereça ações úteis e relevantes na notificação para simplificar a jornada do usuário. Por exemplo, fornecer "Dica" e "Adicionar prato" a um pedido de entrega de comida recém-iniciado são ações úteis antes da entrega.
  • Use segmentos e pontos para indicar estados. Por exemplo, os segmentos podem colorir o estado e a duração do trânsito em uma viagem de transporte por aplicativo. Os pontos representam estados para marcos importantes, como preparo e entrega de alimentos e embarque de passageiros.
  • Atualize a experiência de progresso para refletir com precisão a progressão real da jornada. Por exemplo, mudanças nas condições de trânsito podem ser refletidas em mudanças nas cores dos segmentos e atualizações no texto.

O exemplo a seguir mostra uma notificação de ProgressStyle para um app de carona compartilhada.

O exemplo mostra o uso de uma imagem de veículo para o ícone do rastreador e o uso de segmentos e pontos para indicar a experiência e os marcos importantes de carona compartilhada.

Consulte o app de exemplo para testar essas APIs.