Cette page a été traduite par l'API Cloud Translation.

Notifications

Les notifications fournissent des informations brèves, pertinentes et opportunes concernant votre l'application lorsqu'elle n'est pas utilisée.

Le système d'exploitation Android contrôle de nombreux aspects des notifications, d'autres aspects. Pour implémenter les notifications, procédez comme suit:

comprendre l'anatomie d'une notification ;
Choisissez le type de notification pour votre cas d'utilisation.
Définissez la catégorie de notifications adaptée au type de notification. que vous avez choisis.

Points à retenir

Réfléchissez à l'objectif de la notification: pourquoi alertez-vous vos utilisateurs ?
Déterminez le schéma d'autorisation des notifications et tenez compte de l'importance les notifications concernent votre application et où les poser dans le parcours de votre utilisateur.
Choisissez votre modèle de notification.
Créer le contenu des notifications: <ph type="x-smartling-placeholder">
- Le texte de l'en-tête doit résumer brièvement la notification.
- Un aperçu de la notification doit être affiché dans le contenu textuel de la notification.
- Contenu de l'image, le cas échéant.
- Keyart et métadonnées du modèle multimédia.
Indiquez clairement aux utilisateurs ce qu'ils peuvent faire avec une notification en fournissant des actions en fonction de leur contenu, que ce soit par le biais de boutons de texte, de la saisie de texte .
Incluez l'icône de votre application et définissez sa couleur d'arrière-plan.
Définissez les canaux et les catégories de vos notifications. Cela permet au système et votre utilisateur de personnaliser les notifications qu'ils reçoivent et fournissent comportement prioritaire.
Si votre application peut envoyer plusieurs notifications à la fois, regroupez les notifications.
Consultez Android UI Kit sur Figma pour obtenir des notifications. modèles de ML.

Anatomie d'une notification

Les notifications sont conçues pour que vous puissiez facilement parcourir et utiliser les les éléments importants. En voici la description :

Contenu principal: il s'agit de l'élément le plus proéminent d'une . Les informations secondaires, telles que le code temporel, sont plus petites et sont regroupés au-dessus du contenu principal.
Personnes: si la notification implique une personne, un avatar se distingue des autres. le reste du contenu.
Actions: les utilisateurs peuvent développer les notifications en appuyant sur une icône d'indicateur. Les actions sont affichées avec des libellés de texte sur une couleur d'arrière-plan séparée et l'emplacement.

En-tête et contenu de la notification

Lorsqu'elle est réduite, une notification affiche l'icône de l'application, le texte de l'en-tête, l'horodatage, l'indicateur d'expansion et le texte du contenu. Une grande icône peut également s'afficher si vous le souhaitez.

**Figure 2**:Zone d'en-tête des notifications

1 Icône de l'application:l'icône de l'application est une une représentation bidimensionnelle de l'identité de votre application. Il s'affiche en monochrome. dans la barre d'état. Si votre application envoie une grande variété de notifications, envisagez Remplacer l'icône de votre application par un symbole pour distinguer les différents types de notifications. Consultez Appliquer la couleur de l'icône pour en savoir plus plus de détails.

2 Texte de l'en-tête:bref titre pour le la notification ou la source, comme le nom du compte pour les utilisateurs. Le contenu est le plus un élément bien visible d'une notification.

3 Timestamp:indique à quel moment une notification a été envoyé, par exemple l'heure d'un appel manqué.

4 Indicateur d'expansion:indique si l'élément est réduite ou développée.

5 Texte du contenu:informations complémentaires.

6 Grande icône (facultatif) : l'image peut être aussi bien pour renforcer la notification de façon pertinente, par exemple par le biais d'un message qui comprend un avatar de l'expéditeur.

Appliquer la couleur de l'icône

À partir d'Android 12 (niveau d'API 31), le système dérive la couleur de l'icône la couleur de notification définie dans l'application. Si l'application ne définit pas la couleur, utilise la couleur du thème du système. Auparavant, la couleur était grise.

</ph>

Figure 3:Couleur de l'icône d'application stylisée générée

Pour la plupart des styles, le système n'applique cette couleur que si la notification est pour une notification de service de premier plan. Cependant, une telle exigence ne s'applique pas pour les notifications MediaStyle et DecoratedMediaCustomViewStyle comportant une session multimédia.

L'extrait de code suivant montre comment appliquer la couleur de l'icône.

val notification = Notification.Builder()
    .setColor(Color.GREEN)
    .setColorized(true)
    .setSmallIcon(R.drawable.app_icon)
    .setStyle(Notification.DecoratedCustomViewStyle())
    .build()

Actions de notification

**Figure 4**:Zone d'action des notifications

1 action du bouton "Texte"

2 Boutons d'action remplis

3 suggestions de réponses

4 Champ de texte de la réponse

À partir d'Android 7.0 (niveau d'API 24), le système affiche les actions sans icône pour accueillir plus de texte. Pour prendre en charge les appareils et appareils Android Wear exécutant Android version 6.0 (niveau d'API 23) ou antérieure, votre application doit quand même fournir une .

Vue détaillée

Vous pouvez utiliser une vue développée pour présenter plus d'informations à l'utilisateur sans en quittant la notification.

Lorsqu'elle est développée, une notification peut afficher jusqu'à trois des éléments suivants : types d'actions:

Réponses suggérées
Actions mises en avant (boutons en forme de pilule)
Actions standards sur le texte

À éviter

Inclure les actions textuelles reproduisant le comportement d'appui sur le corps de la notification.

À faire

Donnez à l'utilisateur la possibilité d'interagir avec la notification. L'application Horloge Google affiche un minuteur en cours, mais permet à l'utilisateur de mettre une minute en pause ou d'ajouter une minute directement depuis la notification.

Activer la saisie dans les notifications

Vous permettez à l'utilisateur de saisir du texte directement dans une notification en incluant une réponse action. Cette fonctionnalité est conçue pour saisir une petite quantité de texte, par exemple pour répondre à un un SMS ou la prise de brève note.

Pour une saisie plus longue, redirigez les utilisateurs vers votre application afin de leur donner plus d'espace pour afficher et modifier du texte.

Pour les applications de chat, nous recommandons de laisser la notification visible après l'utilisateur a envoyé la réponse et attend que la conversation soit mise en veille avant que et la ferme automatiquement.

**Figure 5**:Un utilisateur répond directement dans Android Messages. sans quitter la notification après avoir appuyé sur "Répondre"

Choisissez le type de notification en fonction de votre cas d'utilisation

Google utilise les modèles de notification suivants dans ses applications Android. Ces peuvent être personnalisés dans une certaine mesure pour votre application.

Consultez Android UI Kit sur Figma pour obtenir des modèles de notification.

Modèle standard

Le modèle standard convient à la plupart des notifications, ce qui permet du texte, une grande icône (le cas échéant) et des actions.

**Figure 6**:Modèle de notification standard

Modèle avec texte de grande taille

Le modèle de texte de grande taille est idéal pour afficher des blocs de texte plus longs. Elle permet au vous pouvez prévisualiser plus de texte après avoir développé la notification.

**Figure 7**:Modèle de texte de grande taille, avec une grande icône d'option

Modèle de vue d'ensemble

Le modèle Vue d'ensemble est conçu pour les notifications contenant une image. Quand ? réduit, la notification affiche une grande vignette représentant la photo. Quand ? développé, la notification affiche un aperçu beaucoup plus grand.

Modèle de progression

Le modèle de progression est conçu pour les activités lancées par l'utilisateur qui prennent du temps pour terminer. Lorsqu'elle est développée, une notification qui utilise ce modèle affiche une une barre de progression et inclut un bouton "Annuler" action qui permet à l'utilisateur d'arrêter cette activité. (Les activités non résiliables ne justifient pas la réception d'une notification.)

Modèle multimédia

Le modèle multimédia est conçu pour permettre à l'utilisateur de contrôler les contenus multimédias actuellement à partir d'une application.

Lorsqu'elle est réduite, la notification peut afficher jusqu'à trois actions. Le grand peut afficher une image associée, comme une couverture d'album.
Lorsqu'elle est développée, la notification affiche jusqu'à cinq actions, avec une taille ou six actions sans image. L'arrière-plan et les autres éléments notification héritent automatiquement des couleurs de l'image.

Modèle de message

Le modèle MessagingStyle est conçu pour la communication en temps réel. Quand ? développé, une notification utilisant ce modèle permet à l'utilisateur de répondre aux messages à partir de la notification.

Modèle d'appel

Utilisez le modèle CallStyle pour générer des notifications en grand format qui inclure une grande image en pièce jointe et indiquer un appel entrant ou sortant.

Autorisations de notifications

Aussi pertinentes et opportunes que possible, la plupart des notifications sont non exemptée, c'est-à-dire que l'utilisateur doit accepter de recevoir des notifications votre application.

Il existe une exception à cette règle: à partir d'Android 13 (niveau d'API 33), les sessions et applis qui gèrent les appels téléphoniques ne sont pas tenues de demander le consentement de l'utilisateur. Les applications préexistantes peuvent également être éligibles si l'utilisateur a déjà activé les notifications. Pour en savoir plus, consultez Exceptions.

Nous vous recommandons vivement de proposer des options de notification dans les paramètres de votre application pour permettent aux utilisateurs de mettre à jour leurs préférences de notification.

Inviter l'utilisateur à s'abonner aux notifications non exemptées

Pour les notifications non exemptées, demandez à l'utilisateur d'indiquer s'il souhaite pour activer la réception de notifications. Les utilisateurs qui choisissent explicitement de recevoir notifications sont susceptibles de les trouver plus utiles et moins intrusives.

**Figure 13**:Demander le consentement d'un utilisateur pour une notification non exemptée

Attendez que l'invite de la boîte de dialogue de notification s'affiche:

Décrivez les avantages des notifications et le résultat si vous ne les accordez pas autorisations pour les notifications.
Fournir une UI contextuelle, en associant la notification à ses fonctionnalités ou à ce qu'elle affecte. Cette interface utilisateur peut prendre n'importe quelle forme pour mieux s'intégrer à votre application: par exemple de fiche dans les frais, la bottom sheet ou l'écran d'accueil. N'importe lequel de ces éléments doit pouvoir être ignorée.
Ne pas afficher la boîte de dialogue d'autorisation de notification si l'utilisateur a ignoré UI.

À partir d'Android 13, les utilisateurs peuvent être invités à nouveau à accorder des autorisations de notification.

Notifications requises

Les services de premier plan effectuent des opérations qui sont perceptibles pour l'utilisateur, mais bien que s'ils n'interagissent pas directement avec votre application. Ces services affichent une barre d'état pour informer les utilisateurs que votre application effectue une tâche dans la au premier plan et qui consomme des ressources système.

**Figure 14**:Exemple de notification de service de premier plan dans une application de fitness

Comme ces processus utilisent la batterie et éventuellement des données, votre application doit rendre les utilisateurs en affichant une notification que vous ne pourrez pas ignorer. L'utilisateur ne peut pas ignorer la notification. Vous devez donc proposer une action à l'utilisateur pour qu'il arrête Google Cloud.

L'exemple suivant montre une notification provenant d'une application de fitness. L'utilisateur a a démarré une session d'entraînement active, qui instancie un service de premier plan suivre la séance d’entraînement. L'application affiche la notification suivi de la marche, avec la possibilité d'afficher la séance de sport.

Dans quels cas ne pas utiliser une notification ?

N'utilisez pas les notifications pour les cas d'utilisation suivants:

Pour la promotion croisée ou la publicité d'un autre produit (c'est-à-dire strictement interdites par le Play Store)
Si l'utilisateur n'a jamais ouvert votre application
En tant que principal moyen de communication avec les utilisateurs
Pour encourager l'utilisateur à revenir dans une application, mais ne fournir aucune valeur directe (par exemple : "Je ne t'ai pas vu depuis un moment !")
Pour les demandes d'évaluation de votre appli
Pour les opérations ne nécessitant pas l'intervention de l'utilisateur, comme la synchronisation informations
Annoncer les états d'erreur à partir desquels l'application peut effectuer une récupération sans interaction de l'utilisateur
Pour les messages de vacances ou d'anniversaire

À éviter

Envoyer messages de vœux ou d'anniversaire sous forme de notifications.

À éviter

interrompre l’utilisateur au milieu d’une tâche dans le seul but de lui demander si vous faites du bon travail.

Comportement

Tenez compte des comportements de notification suivants et de la manière de les gérer dans dans certains contextes.

Arrivée des notifications

Lorsque vous recevez une notification, Android l'ajoute au panneau des notifications. Selon les paramètres que vous définissez et l'état actuel de l'appareil, peut effectuer l'une des actions suivantes:

Émettez un son ou faites vibrer votre téléphone.
Afficher dans la barre d'état avec une icône. il s'agit généralement de l'icône de votre application, mais Si vous avez plusieurs types de notifications, utilisez un symbole qui représente l'objet de la notification.
Afficher sous forme de notification prioritaire, jetant un coup d'œil sur l'écran actuel pour saisir l'attention de l'utilisateur.

Comme toujours, l'utilisateur peut choisir de modifier les comportements de notification que vous définissez.

1 Indicateur de notification dans la barre d'état, indiquant qu'une notification s'affiche dans le panneau des notifications.

2 Notification "en aperçu" sur l'écran actuel pour attirer l'attention d'un utilisateur au milieu d'une tâche.

Panneau des notifications

Le panneau des notifications d'Android affiche généralement les notifications dans l'ordre chronologique inverse, avec des ajustements influencés par les éléments suivants conditions:

Priorité ou importance des notifications de l'application
Indique si la notification a récemment alerté l'utilisateur via un son ou une vibration
Toutes les personnes jointes à la notification et leur statut de contacts favoris
Indique si la notification représente une activité en cours importante, telle qu'une appel téléphonique en cours ou musique en cours de lecture
Les modifications de l'apparence de certaines notifications par le système d'exploitation Android au niveau en haut et en bas de la liste en ajoutant une emphase ou une diminution, ce qui aide analyse de contenu par l'utilisateur

Gérer les notifications obsolètes

Le panneau des notifications est conçu pour afficher des informations pertinentes aux utilisateurs. pour l'instant présent. Si une notification antérieure est obsolète, qui n'est plus pertinent, fermez-le pour que l'utilisateur ne le voie pas.

**Figure 16**:le texte d'arrivée s'affiche en haut de la panneau des notifications, avec une notification de priorité inférieure concernant l'ajout d'une photo sur en bas

Les nouvelles notifications sont signalées par un badge sur l'icône de l'application.

Dans les lanceurs compatibles sur les appareils équipés d'Android 8.0 (niveau d'API 26) ou version ultérieure : les icônes des applications affichent une point de notification pour indiquer que l'application dispose d'une nouvelle la notification qui lui est associée. Ces points apparaissent par défaut dans les applications de lanceur qui les prennent en charge, et votre application n'a rien à faire. Les badges peuvent également être désactivées et limitées.

**Figure 17**:Point de notification sur une icône d'application, indiquant la appli est associée à une nouvelle notification

Actions que les utilisateurs peuvent effectuer avec les notifications

Les notifications peuvent permettre aux utilisateurs d'effectuer les actions suivantes:

Accéder à une destination: pour y accéder, l'utilisateur peut appuyer sur une notification. Si le s'affiche sur un écran verrouillé, l'utilisateur doit appuyer deux fois dessus, puis puis saisissez son code, schéma ou mot de passe.

Lorsque l'utilisateur appuie sur une notification, votre application doit afficher l'UI correspondante. directement à cette notification et permet à l'utilisateur d'agir immédiatement. Pour Par exemple, si la notification indique que c'est à leur tour dans un jeu à deux, appuyer sur la notification devrait le mener directement à ce jeu.
Afficher une vue développée de la notification: un indicateur d'expansion apparaît dans en-tête. L'utilisateur peut tapoter sur l'indicateur ou faire glisser le corps de la notification vers le bas la développer.
<ph type="x-smartling-placeholder">
</ph>
Figure 18:notification développée
Ignorer la notification (si cela est autorisé): l'utilisateur peut l'ignorer en la balayant. vers la gauche ou vers la droite.

Notifications en cours indiquant un processus en arrière-plan, tel que lorsque la musique est en cours de lecture, vous ne pouvez pas la fermer d'un simple geste.

Répéter une notification prioritaire: l'utilisateur peut balayer l'écran vers le haut notification, et aucune autre notification de cet événement n'est autorisée clignoter pendant une minute.
Contrôler les notifications similaires à l'avenir: les utilisateurs peuvent accéder aux notifications par:
- Touchez et maintien d'une notification individuelle
- En balayant la notification vers la gauche ou vers la droite, puis en appuyant sur l'icône des paramètres

Les commandes affichées varient selon la version d'Android et selon que l'application dispose de canaux de notification (à partir d'Android 8.0).

Regrouper plusieurs notifications

Pour les applications qui génèrent plusieurs notifications du même type, Android propose afin d'éviter de surcharger les utilisateurs.

Votre application peut présenter plusieurs notifications selon les critères suivants : la hiérarchie.

Une notification parente affiche un résumé des notifications enfants.
Si l'utilisateur développe la notification parente, Android affiche tous les éléments enfants les notifications.
L'utilisateur peut développer une notification enfant pour afficher l'intégralité de son contenu.

Android présente les notifications enfants sans informations d'en-tête en double. Pour Par exemple, si une notification enfant a la même icône d'application que son parent, l'en-tête de l'élément enfant ne comporte pas d'icône.

Les notifications des enfants doivent être compréhensibles si elles apparaissent seules, car le système peut les montrer en dehors du groupe lorsqu'ils arrivent.

**Figure 19**:Notifications groupées réduites et développées

Paramètres

Chaînes

À 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 cette chaîne. Les utilisateurs peuvent modifier ces paramètres et déterminez quels canaux de notification de votre appli peuvent être intrusifs ou visible.

Pour en savoir plus sur la mise en œuvre, consultez la section Créer et gérer des notifications canaux.

L'importance doit être choisie en tenant compte du temps de l'utilisateur et votre attention. Lorsqu'une notification sans importance est déguisée en urgente, déclencher une alarme inutile.

Importance	Comportement	Utilisation	Exemples
`HIGH`	Émet un son et s'affiche à l'écran	Informations urgentes que l'utilisateur doit connaître ou traiter immédiatement	Messages texte, alarmes, appels téléphoniques
`DEFAULT`	Émet un son	Informations qui doivent être vues le plus tôt possible par l'utilisateur, mais qui ne doivent pas interrompre ce qu'il fait	Alertes de trafic, rappels de tâches
`LOW`	Pas de son	Canaux de notification qui ne répondent pas aux exigences d'autres niveaux d'importance	Nouveaux contenus auxquels l'utilisateur s'est abonné, invitations sur les réseaux sociaux
`MIN`	Aucune interruption sonore ni visuelle	Informations non essentielles qui peuvent attendre ou qui ne sont pas spécifiquement pertinentes pour l'utilisateur	Lieux d'intérêt, météo, contenus promotionnels à proximité

Catégories prédéfinies

Que vous utilisiez des canaux ou non, associez chaque notification au paramètre la catégorie prédéfinie la plus adaptée. Android peut utiliser ces informations pour de classement et de filtrage.

Catégorie	Description
`CATEGORY_CALL`	Appel entrant (vocal ou vidéo) ou demande de communication synchrone similaire
`CATEGORY_MESSAGE`	Message privé entrant (SMS, message instantané, etc.)
`CATEGORY_EMAIL`	Message en masse asynchrone (e-mail)
`CATEGORY_EVENT`	Événement d'agenda
`CATEGORY_PROMO`	Promotion ou publicité
`CATEGORY_ALARM`	Alarme ou minuteur
`CATEGORY_PROGRESS`	Progression d'une opération de longue durée en arrière-plan
`CATEGORY_SOCIAL`	Mise à jour liée aux réseaux sociaux ou aux partages
`CATEGORY_ERROR`	Erreur lors de l'opération en arrière-plan ou de l'état d'authentification
`CATEGORY_TRANSPORT`	Commande de transport multimédia pour la lecture
`CATEGORY_SYSTEM`	Mise à jour de l'état du système ou de l'appareil. Réservé à l'utilisation du système.
`CATEGORY_SERVICE`	Indication de l'exécution du service d'arrière-plan
`CATEGORY_RECOMMENDATION`	Une recommandation spécifique et opportune pour un seul élément. Par exemple, une application d'actualités peut recommander un sujet d'actualité que l'utilisateur pourrait vouloir lire ensuite.
`CATEGORY_STATUS`	Informations en continu sur l'état de l'appareil ou du contexte

Notifications sur l'écran de verrouillage

Si un utilisateur a choisi d'afficher des notifications lorsque son écran est verrouillé, ces les notifications peuvent dissimuler tout contenu identifié par votre application comme sensible. Android et évalue le niveau de visibilité de chaque notification pour déterminer affichés.

Définir le niveau de sensibilité du contenu sur l'écran de verrouillage

La confidentialité des utilisateurs est très importante. niveaux de notification visibles sur l'écran de verrouillage. Pour chaque que vous créez, vous devez définir le niveau de visibilité sur public, privé, ou secret.

Les notifications publiques sont entièrement visibles sur les écrans de verrouillage sécurisés.
Les notifications de secrets sont masquées.
Les notifications privées se situent au milieu: elles n'affichent que des informations de base, y compris le nom de l'application qui l'a publié et son icône. Au lieu du du contenu standard (masqué), vous avez la possibilité d'afficher du texte ne divulgue aucune information personnelle, telle que 2 new messages.

Dans l'exemple suivant, les notifications sur l'écran de verrouillage pour Gmail et Photos applications affichent tout le contenu une fois que l'utilisateur a choisi d'afficher ces informations sur le l'écran de verrouillage.

**Figure 20**:Écran de verrouillage avec différents niveaux de sensibilité

1 Tout le contenu des notifications affiché sur l'écran de verrouillage

2 Contenu sensible des notifications masqué sur l'écran de verrouillage

Style

Texte clair et concis

Android tronque les titres de contenu sur une seule ligne (même lorsqu'ils sont développés).

Pour être efficace, un titre doit respecter les consignes suivantes:

Ne doit pas dépasser 30 caractères
Contient les informations les plus importantes
Évite les variables (sauf si elles contiennent un nombre ou une chaîne de texte courte, ou précédé d'un texte)
Exclut le nom de l'application, qui apparaît déjà dans l'en-tête

À éviter

Afficher le nom de l'application dans le titre du contenu, qui se superpose à la zone d'en-tête et utilise les caractères disponibles

À faire

Affichez les informations les plus importantes dans le titre du contenu.

Un texte de qualité doit respecter les consignes suivantes:

Éviter de dépasser la limite de 40 caractères
Évite de répéter le contenu du titre

La grande icône

Utilisez la grande icône pour les cas d'utilisation dans lesquels les images renforcent de manière significative le contenu de la notification. Par exemple :

Les communications d'une autre personne, comme l'image d'une personne envoyant une message
La source du contenu si elle est différente de l'application qui envoie la notification comme le logo d'une chaîne YouTube à laquelle l'utilisateur est abonné
Symboles pertinents concernant la notification, comme une flèche pour conduire itinéraire

Les grandes icônes doivent être circulaires lorsqu'elles représentent une personne, mais carrées dans toutes les autres cas d'utilisation.

À éviter

Utilisez la grande icône pour l'image de marque.

À faire

Utilisez la grande icône pour renforcer le contenu d'une notification de façon pertinente (par exemple, en affichant la photo d'une personne jointe à une notification de message).

Mises à jour de la version d'Android

L'UI du système de notification Android et les API de notification évoluer. Pour obtenir la liste de ces modifications, consultez la notification compatibilité.

Remarques concernant la plate-forme

Wear

Si l'utilisateur possède un appareil Wear OS associé, toutes vos notifications s'y affichent. automatiquement, y compris des boutons d'action et de détails à développer. Pour en savoir plus, consultez la page de conception des notifications sur Wear.