A partir da versão 8.0 (API de nível 26), os indicadores de notificação (conhecidos também como pontos de notificação) aparecem no ícone da tela de início quando o app associado tem uma notificação ativa. Os usuários podem tocar no ícone do app e mantê-lo pressionado para exibir as notificações (ao lado de qualquer atalho do app), conforme mostrado na figura 1.
Esses pontos aparecem por padrão em apps de inicialização compatíveis, e não há nada que seu app precise fazer. No entanto, pode haver situações em que você não queira que o ponto de notificação apareça ou que queira controlar exatamente quais notificações serão exibidas.
Figura 1. Indicadores de notificação e menu exibido depois de tocar e manter pressionado.
Desativar a exibição de indicadores
Há casos em que os indicadores não fazem sentido para suas notificações. Sendo assim, você pode desativá-los por canal chamando setShowBadge(false)
no objeto NotificationChannel
.
Por exemplo, convém desativar os indicadores de notificação nas seguintes situações:
- Notificações em andamento: a maioria das notificações em andamento, como processamento de imagem, controles de mídia ou instruções de navegação atuais, não faz sentido como indicador.
- Lembretes da agenda: evite exibir indicadores para eventos que estejam ocorrendo no momento.
- Eventos de relógio ou alarme: evite exibir indicadores para notificações relacionadas a alarmes atuais.
Este exemplo de código ilustra como ocultar indicadores para um canal de notificação:
Kotlin
val id = "my_channel_01" val name = getString(R.string.channel_name) val descriptionText = getString(R.string.channel_description) val importance = NotificationManager.IMPORTANCE_LOW val mChannel = NotificationChannel(id, name, importance).apply { description = descriptionText setShowBadge(false) } val notificationManager = getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager notificationManager.createNotificationChannel(mChannel)
Java
String id = "my_channel_01"; CharSequence name = getString(R.string.channel_name); String description = getString(R.string.channel_description); int importance = NotificationManager.IMPORTANCE_LOW; NotificationChannel mChannel = new NotificationChannel(id, name, importance); mChannel.setDescription(description); mChannel.setShowBadge(false); NotificationManager notificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE); notificationManager.createNotificationChannel(mChannel);
Definir contagem de notificações personalizada
Por padrão, cada notificação incrementa um número exibido no menu de pressionamento longo (visível na figura 1), mas você pode modificar esse número no app. Por exemplo, isso poderá ser útil se você estiver usando apenas uma notificação para representar várias novas mensagens, mas quiser que a contagem represente o número total de novas mensagens.
Para definir um número personalizado, chame setNumber()
na notificação, conforme mostrado aqui:
Kotlin
var notification = NotificationCompat.Builder(this@MainActivity, CHANNEL_ID) .setContentTitle("New Messages") .setContentText("You've received 3 new messages.") .setSmallIcon(R.drawable.ic_notify_status) .setNumber(messageCount) .build()
Java
Notification notification = new NotificationCompat.Builder(MainActivity.this, CHANNEL_ID) .setContentTitle("New Messages") .setContentText("You've received 3 new messages.") .setSmallIcon(R.drawable.ic_notify_status) .setNumber(messageCount) .build();
Modificar o ícone do menu de pressionamento longo de uma notificação
O menu de pressionamento longo exibe o ícone pequeno ou grande associado à uma notificação, se disponível. Por padrão, o sistema exibe o ícone grande, mas é possível chamar Notification.Builder.setBadgeIconType()
e passar a constante BADGE_ICON_SMALL
para exibir o ícone pequeno.
Kotlin
var notification = NotificationCompat.Builder(this@MainActivity, CHANNEL_ID) .setContentTitle("New Messages") .setContentText("You've received 3 new messages.") .setSmallIcon(R.drawable.ic_notify_status) .setBadgeIconType(NotificationCompat.BADGE_ICON_SMALL) .build()
Java
Notification notification = new NotificationCompat.Builder(MainActivity.this, CHANNEL_ID) .setContentTitle("New Messages") .setContentText("You've received 3 new messages.") .setSmallIcon(R.drawable.ic_notify_status) .setBadgeIconType(NotificationCompat.BADGE_ICON_SMALL) .build();
Ocultar um atalho duplicado
Se seu app criar uma notificação que duplique um atalho de app, você poderá ocultar temporariamente o atalho enquanto a notificação estiver ativa chamando setShortcutId()
.
Para ver mais exemplos de códigos que usam notificações, consulte o Exemplo de notificações do Android (em inglês).