Créer et gérer des canaux de notification

À partir d'Android 8.0 (niveau d'API 26), toutes les notifications doivent être attribuées à un canal. Pour chaque canal, vous pouvez définir le comportement visuel et auditif appliqué à toutes les notifications de ce canal. Les utilisateurs peuvent modifier ces paramètres et décider quels canaux de notification de votre application peuvent être intrusifs ou visibles.

Regardez la vidéo suivante pour découvrir un aperçu des canaux et des autres fonctionnalités de notification d'Android 8.0.

Les paramètres utilisateur des canaux de notification sont disponibles pour chaque application dans les paramètres système, comme illustré dans la figure 1.

Figure 1. Paramètres de notification pour l'application Horloge et l'un de ses canaux.

Remarque : Dans l'interface utilisateur, les canaux de notification sont appelés "catégories".

Une fois que vous avez créé un canal de notification, vous ne pouvez plus modifier les comportements de notification. L'utilisateur a alors le contrôle total. Toutefois, vous pouvez toujours modifier le nom et la description d'une chaîne.

Créez un canal pour chaque type de notification que vous devez envoyer. Vous pouvez également créer des canaux de notification pour refléter les choix effectués par les utilisateurs. Par exemple, vous pouvez configurer des canaux de notification distincts pour chaque groupe de conversation créé par un utilisateur dans une application de chat.

Attention : Si vous ciblez Android 8.0 (niveau d'API 26) ou une version ultérieure et que vous publiez une notification sans spécifier de canal de notification, la notification ne s'affiche pas et le système consigne une erreur.

Lorsque vous ciblez Android 8.0 (niveau d'API 26) ou une version ultérieure, vous devez implémenter un ou plusieurs canaux de notification. Si votre targetSdkVersion est défini sur 25 ou moins, lorsque votre application s'exécute sur Android 8.0 (niveau d'API 26) ou version ultérieure, elle se comporte de la même manière que sur les appareils équipés d'Android 7.1 (niveau d'API 25) ou version antérieure.

Remarque : À partir d'Android 8.0 (niveau d'API 26), vous pouvez activer un paramètre sur votre appareil de développement pour afficher un avertissement à l'écran sous la forme d'un toast lorsqu'une application ciblant Android 8.0 (niveau d'API 26) ou version ultérieure tente de publier sans canal de notification. Pour activer le paramètre sur un appareil de développement équipé d'Android 8.0 (niveau d'API 26) ou version ultérieure, accédez à Paramètres > Options pour les développeurs, puis activez Afficher les avertissements du canal de notification.

Créer un canal de notification

Pour créer un canal de notification, procédez comme suit :

1. Créez un objet NotificationChannel avec un ID de canal unique, un nom visible par l'utilisateur et un niveau d'importance.

2. Vous pouvez éventuellement spécifier la description que l'utilisateur voit dans les paramètres système avec setDescription().

3. Enregistrez le canal de notification en le transmettant à createNotificationChannel().

Attention : Protégez ce code avec une condition sur la version SDK_INT pour qu'il ne s'exécute que sur Android 8.0 (niveau d'API 26) ou version ultérieure, car les API de canaux de notification ne sont pas disponibles dans la bibliothèque Support.

L'exemple suivant montre comment créer et enregistrer un canal de notification :

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    // Create the NotificationChannel.
    val importance = NotificationManager.IMPORTANCE_DEFAULT
    val mChannel = NotificationChannel(CHANNEL_ID, name, importance)
    mChannel.description = descriptionText
    // Register the channel with the system. You can't change the importance
    // or other notification behaviors after this.
    val notificationManager =
        context.getSystemService(NotificationManager::class.java)
    notificationManager?.createNotificationChannel(mChannel)
}
NotificationsSnippets.kt

La recréation d'un canal de notification existant avec ses valeurs d'origine n'effectue aucune opération. Vous pouvez donc appeler ce code en toute sécurité au démarrage d'une application.

Par défaut, toutes les notifications publiées sur un canal donné utilisent les comportements visuels et auditifs définis par le niveau d'importance de la classe NotificationManagerCompat, tels que IMPORTANCE_DEFAULT ou IMPORTANCE_HIGH. Pour en savoir plus sur les niveaux d'importance, consultez la section suivante.

Si vous souhaitez personnaliser davantage les comportements de notification par défaut de votre canal, vous pouvez appeler des méthodes telles que enableLights(), setLightColor() et setVibrationPattern() sur NotificationChannel. N'oubliez pas qu'une fois le canal créé, vous ne pouvez plus modifier ces paramètres et que l'utilisateur a le contrôle final sur l'activation de ces comportements.

Vous pouvez également créer plusieurs canaux de notification en une seule opération en appelant createNotificationChannels().

Remarque : En plus d'ajouter chaque notification à vos canaux spécifiques à l'application, envisagez d'ajouter chaque notification à l'une des catégories à l'échelle du système, telles que CATEGORY_ALARM ou CATEGORY_REMINDER.

Définir le niveau d'importance

L'importance du canal affecte le niveau d'interruption de toutes les notifications publiées dans le canal. Spécifiez-le dans le constructeur NotificationChannel, en utilisant l'un des cinq niveaux d'importance, de IMPORTANCE_NONE(0) à IMPORTANCE_HIGH(4).

Pour assurer la compatibilité avec les appareils équipés d'Android 7.1 (niveau d'API 25) ou version antérieure, vous devez également appeler setPriority() pour chaque notification, en utilisant une constante de priorité de la classe NotificationCompat.

Les constantes d'importance (NotificationManager.IMPORTANCE_*) et de priorité (NotificationCompat.PRIORITY_*) correspondent aux options d'importance visibles par l'utilisateur, comme indiqué dans le tableau suivant.

Niveau d'importance visible par l'utilisateur	Importance (Android 8.0 ou version ultérieure)	Priorité (Android 7.1 et versions antérieures)
Urgence Émet un signal sonore et s'affiche sous la forme d'une notification prioritaire.	IMPORTANCE_HIGH	PRIORITY_HIGH ou PRIORITY_MAX
Élevée Émet un son.	IMPORTANCE_DEFAULT	PRIORITY_DEFAULT
Moyen N'émet aucun son.	IMPORTANCE_LOW	PRIORITY_LOW
Faible La notification n'émet aucun son et n'apparaît pas dans la barre d'état.	IMPORTANCE_MIN	PRIORITY_MIN
Aucune N'émet aucun son et n'apparaît pas dans la barre d'état ni dans le volet des notifications.	IMPORTANCE_NONE	N/A

Toutes les notifications, quelle que soit leur importance, s'affichent dans des emplacements non intrusifs de l'interface utilisateur du système, par exemple dans le panneau des notifications et sous la forme d'un badge sur l'icône du lanceur d'applications. Vous pouvez toutefois modifier l'apparence du badge de notification.

Une fois que vous avez envoyé le canal à NotificationManager, vous ne pouvez plus modifier le niveau d'importance. Toutefois, l'utilisateur peut modifier ses préférences pour les canaux de votre application à tout moment.

Pour savoir comment choisir un niveau de priorité approprié, consultez la section "Niveaux de priorité" du guide de conception des notifications.

Lire les paramètres du canal de notification

Les utilisateurs peuvent modifier les paramètres des canaux de notification, y compris les comportements tels que le vibreur et le son d'alerte. Si vous souhaitez connaître les paramètres qu'un utilisateur applique à vos canaux de notification, procédez comme suit :

1. Obtenez l'objet NotificationChannel en appelant getNotificationChannel() ou getNotificationChannels().

2. Interrogez les paramètres spécifiques d'un canal, tels que getVibrationPattern(), getSound() et getImportance().

Si vous détectez un paramètre de canal qui, selon vous, empêche le comportement prévu pour votre application, vous pouvez suggérer à l'utilisateur de le modifier et fournir une action pour ouvrir les paramètres du canal, comme indiqué dans la section suivante.

Ouvrir les paramètres du canal de notification

Une fois que vous avez créé un canal de notification, vous ne pouvez plus modifier ses comportements visuels et sonores de manière programmatique. Seul l'utilisateur peut modifier les comportements des canaux dans les paramètres système. Pour permettre à vos utilisateurs d'accéder rapidement à ces paramètres de notification, ajoutez un élément dans l'UI des paramètres de votre application qui ouvre ces paramètres système.

Vous pouvez ouvrir les paramètres système des canaux de notification avec un Intent qui utilise l'action ACTION_CHANNEL_NOTIFICATION_SETTINGS.

Par exemple, l'exemple de code suivant montre comment rediriger un utilisateur vers les paramètres d'un canal de notification :

val intent = Intent(Settings.ACTION_CHANNEL_NOTIFICATION_SETTINGS).apply {
    putExtra(Settings.EXTRA_APP_PACKAGE, context.packageName)
    putExtra(Settings.EXTRA_CHANNEL_ID, CHANNEL_ID)
}
Button(onClick = {
    context.startActivity(intent)
}) {
    Text("Open Channel Settings")
}
NotificationsSnippets.kt

Notez que l'intent nécessite deux extras qui spécifient le nom du package de votre application (également appelé ID d'application) et le canal à modifier.

Supprimer un canal de notification

Vous pouvez supprimer des canaux de notification en appelant deleteNotificationChannel(). L'exemple de code suivant vous montre comment effectuer cette opération :

val notificationManager =
    ContextCompat.getSystemService<NotificationManager>(context, NotificationManager::class.java)
notificationManager?.deleteNotificationChannel(channelId)
NotificationsSnippets.kt

Remarque : L'écran des paramètres de notification affiche le nombre de canaux supprimés, afin d'éviter le spam. Vous pouvez effacer les canaux de test sur les appareils de développement en réinstallant l'application ou en effaçant les données associées à votre copie de l'application.

Créer un groupe de canaux de notification

Si vous souhaitez organiser davantage l'apparence de vos canaux dans l'interface utilisateur des paramètres, vous pouvez créer des groupes de canaux. Cette approche est utile lorsque votre application est compatible avec plusieurs comptes utilisateur, car elle vous permet de créer un groupe de canaux de notification pour chaque compte. Les groupes de canaux aident les utilisateurs à différencier et à contrôler plusieurs canaux de notification portant des noms identiques.

Figure 2. Paramètres des canaux de notification avec des groupes pour les comptes personnels et professionnels.

Par exemple, une application de réseau social peut prendre en charge les comptes personnels et professionnels. Dans ce scénario, chaque compte peut nécessiter plusieurs canaux de notification avec des fonctions et des noms identiques, tels que les suivants :

• Un compte personnel avec deux chaînes :

  • Nouveaux commentaires

  • Recommandations de posts

• Un compte d'entreprise avec deux chaînes :

  • Nouveaux commentaires

  • Recommandations de posts

Organiser les canaux de notification en groupes pour chaque compte permet aux utilisateurs de les distinguer.

Chaque groupe de canaux de notification nécessite un ID, qui doit être unique dans votre package, ainsi qu'un nom visible par l'utilisateur. L'extrait de code suivant montre comment créer un groupe de canaux de notification.

fun createNotificationChannelGroup(context: Context, groupId: String, groupName: String) {
    val notificationManager =
        ContextCompat.getSystemService(context, NotificationManager::class.java)
    notificationManager?.createNotificationChannelGroup(NotificationChannelGroup(groupId, groupName))
}
NotificationsSnippets.kt

Après avoir créé un groupe, vous pouvez appeler setGroup() pour associer un nouvel objet NotificationChannel au groupe.

Une fois que vous avez envoyé le canal au gestionnaire de notifications, vous ne pouvez plus modifier l'association entre le canal de notification et le groupe.