Modifier un badge de notification

À partir d'Android 8.0 (niveau d'API 26), les badges de notification pastilles de notification : elles apparaissent sur une icône de lanceur lorsque l'application associée dispose d'une notification active. Les utilisateurs peuvent appuyer et appuyez de manière prolongée sur l'icône de l'application pour afficher les notifications, ainsi que les raccourcis d'application, comme indiqué dans figure 1.

Ces points apparaissent par défaut dans les applications de lanceur compatibles et il y a votre application n'a rien à faire. Cependant, il peut y avoir des situations dans lesquelles si vous ne voulez pas que la pastille de notification s'affiche ou si vous voulez contrôler quelles notifications s'y trouvent.

Figure 1 : Badges de notification et commandes tactiles appuyez sur le menu d'appui.

Désactiver les badges

Dans certains cas, les badges n'ont aucun sens pour vos notifications, vous vous pouvez les désactiver pour chaque canal en appelant setShowBadge(false) sur votre NotificationChannel .

Vous pouvez par exemple désactiver les badges de notification dans les situations suivantes:

• Notifications en cours: la plupart des notifications en cours, telles que le traitement d'image, les commandes de lecture multimédia ou les instructions de navigation actuelles n'ont aucun sens sous forme de badge.
• Rappels de l'agenda: évitez de marquer des événements à l'heure actuelle.
• Événements d'horloge ou d'alarme: évitez de recevoir des notifications par badge pour les alarmes en cours.

L'exemple de code suivant montre comment masquer les badges pour un canal de notification:

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);

Définir le nombre de notifications personnalisé

Par défaut, chaque notification incrémente un nombre affiché sur les écrans tactiles et appui long comme illustré dans la figure 1, mais vous pouvez remplacer ce numéro pour votre application. Cela peut être utile, par exemple, si vous n'utilisez qu'une seule notification plusieurs nouveaux messages, mais que vous souhaitez le nombre total de nouveaux messages.

Pour définir un numéro personnalisé, appelez setNumber() sur la notification, comme indiqué ci-dessous:

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();

Modifier l'appui sur une notification icône de menu de manière prolongée

Le toucher et affiche la grande ou la petite icône associée à notification, le cas échéant. Par défaut, le système affiche la grande icône, mais tu peux appeler Notification.Builder.setBadgeIconType() et transmettez BADGE_ICON_SMALL pour afficher la petite icône.

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();

Masquer un raccourci en double

Si votre application crée une notification qui duplique un raccourci d'application, vous pouvez masquer temporairement le raccourci lorsque la notification est active en appelant setShortcutId()

Pour obtenir d'autres exemples de code utilisant des notifications, consultez l'exemple "People".