Représente les options de notification spécifiques à Android qui peuvent être incluses dans AndroidConfig .
Signature:
export interface AndroidNotification
Propriétés
Propriété | Taper | Description |
---|---|---|
corps | chaîne | Corps de la notification Android. Lorsqu'il est fourni, remplace le corps défini via admin.messaging.Notification . |
corpsLocArgs | chaîne[] | Tableau de clés de ressources qui seront utilisées à la place des spécificateurs de format dans bodyLocKey . |
clé de verrouillage du corps | chaîne | Clé de la chaîne du corps dans la ressource chaîne de l'application à utiliser pour localiser le corps du texte. |
Identifiant de la chaine | chaîne | L'ID du canal de notification Android (nouveau dans Android O). L'application doit créer une chaîne avec cet ID de chaîne avant qu'une notification avec cet ID de chaîne puisse être reçue. Si vous n'envoyez pas cet ID de canal dans la demande, ou si l'ID de canal fourni n'a pas encore été créé par l'application, FCM utilise l'ID de canal spécifié dans le manifeste de l'application. |
cliquez sur Action | chaîne | Action associée à un utilisateur cliquant sur la notification. Si spécifié, une activité avec un filtre d'intention correspondant est lancée lorsqu'un utilisateur clique sur la notification. |
couleur | chaîne | Couleur de l’icône de notification au format #rrggbb . |
Paramètres de lumière par défaut | booléen | S'il est défini sur true , utilisez les paramètres d'éclairage LED par défaut du framework Android pour la notification. Les valeurs par défaut sont spécifiées dans config.xml . Si default_light_settings est défini sur true et light_settings est également défini, le light_settings spécifié par l'utilisateur est utilisé à la place de la valeur par défaut. |
Son par défaut | booléen | S'il est défini sur true , utilisez le son par défaut du framework Android pour la notification. Les valeurs par défaut sont spécifiées dans config.xml . |
par défautVibrateTimings | booléen | S'il est défini sur true , utilisez le modèle de vibration par défaut du framework Android pour la notification. Les valeurs par défaut sont spécifiées dans config.xml . Si default_vibrate_timings est défini sur true et vibrate_timings est également défini, la valeur par défaut est utilisée à la place de vibrate_timings spécifié par l'utilisateur. |
événementTimestamp | Date | Pour les notifications qui informent les utilisateurs sur des événements avec une référence temporelle absolue, définit l'heure à laquelle l'événement dans la notification s'est produit. Les notifications dans le panneau sont triées selon cette heure. |
icône | chaîne | Ressource d'icône pour la notification Android. |
URL de l'image | chaîne | URL d'une image à afficher dans la notification. |
Paramètres d'éclairage | Paramètres d'éclairage | Paramètres permettant de contrôler le taux de clignotement et la couleur de la LED de notification si la LED est disponible sur l'appareil. Le temps de clignotement total est contrôlé par le système d'exploitation. |
local uniquement | booléen | Définit si cette notification concerne uniquement l'appareil actuel. Certaines notifications peuvent être reliées à d'autres appareils pour un affichage à distance, comme une montre Wear OS. Cet indice peut être défini pour recommander que cette notification ne soit pas pontée. Consultez les guides Wear OS . |
nombre de notifications | nombre | Définit le nombre d’éléments représentés par cette notification. Peut être affiché sous forme de nombre de badges pour les lanceurs prenant en charge les badges. Voir NotificationBadge . Par exemple, cela peut être utile si vous utilisez une seule notification pour représenter plusieurs nouveaux messages mais que vous souhaitez que le nombre ici représente le nombre total de nouveaux messages. S'il est nul ou non spécifié, les systèmes prenant en charge les badges utilisent la valeur par défaut, qui consiste à incrémenter un nombre affiché dans le menu enfoncé à chaque fois qu'une nouvelle notification arrive. |
priorité | ('min' | 'faible' | 'par défaut' | 'élevé' | 'max') | Définit la priorité relative de cette notification. Les notifications de faible priorité peuvent être masquées à l'utilisateur dans certaines situations. Notez que cette priorité diffère de AndroidMessagePriority . Cette priorité est traitée par le client après la remise du message. Alors AndroidMessagePriority est un concept FCM qui contrôle le moment où le message est remis. |
son | chaîne | Nom de fichier du son à jouer lorsque l'appareil reçoit la notification. |
collant | booléen | Lorsqu'elle est définie sur false ou non définie, la notification est automatiquement ignorée lorsque l'utilisateur clique dessus dans le panneau. Lorsqu'elle est définie sur true , la notification persiste même lorsque l'utilisateur clique dessus. |
étiqueter | chaîne | Balise de notification. Il s'agit d'un identifiant utilisé pour remplacer les notifications existantes dans le tiroir de notifications. Si non spécifié, chaque demande crée une nouvelle notification. |
téléscripteur | chaîne | Définit le texte du « ticker » qui est envoyé aux services d'accessibilité. Avant le niveau d'API 21 (Lollipop), définit le texte affiché dans la barre d'état lorsque la notification arrive pour la première fois. |
titre | chaîne | Titre de la notification Android. Lorsqu'il est fourni, remplace le titre défini via admin.messaging.Notification . |
titreLocArgs | chaîne[] | Un tableau de clés de ressources qui seront utilisées à la place des spécificateurs de format dans titleLocKey . |
titreLocKey | chaîne | Clé de la chaîne de titre dans la ressource chaîne de l'application à utiliser pour localiser le texte du titre. |
vibrerTimingsMillis | nombre[] | Définit le modèle de vibration à utiliser. Passez quelques millisecondes pour allumer ou éteindre le vibrateur. La première valeur indique la durée à attendre avant d'allumer le vibreur. La valeur suivante indique la durée pendant laquelle le vibrateur reste allumé. Les valeurs suivantes alternent entre la durée pour éteindre le vibrateur et pour allumer le vibrateur. Si vibrate_timings est défini et default_vibrate_timings est défini sur true , la valeur par défaut est utilisée à la place de vibrate_timings spécifié par l'utilisateur. |
visibilité | (« privé » | « public » | « secret ») | Définit la visibilité de la notification. Doit être private , public ou secret . Si non spécifié, la valeur par défaut est private . |
AndroidNotification.body
Corps de la notification Android. Lorsqu'il est fourni, remplace le corps défini via admin.messaging.Notification
.
Signature:
body?: string;
AndroidNotification.bodyLocArgs
Un tableau de clés de ressources qui seront utilisées à la place des spécificateurs de format dans bodyLocKey
.
Signature:
bodyLocArgs?: string[];
AndroidNotification.bodyLocKey
Clé de la chaîne du corps dans la ressource chaîne de l'application à utiliser pour localiser le corps du texte.
Signature:
bodyLocKey?: string;
AndroidNotification.channelId
L'ID du canal de notification Android (nouveau dans Android O). L'application doit créer une chaîne avec cet ID de chaîne avant qu'une notification avec cet ID de chaîne puisse être reçue. Si vous n'envoyez pas cet ID de canal dans la demande, ou si l'ID de canal fourni n'a pas encore été créé par l'application, FCM utilise l'ID de canal spécifié dans le manifeste de l'application.
Signature:
channelId?: string;
AndroidNotification.clickAction
Action associée à un utilisateur cliquant sur la notification. Si spécifié, une activité avec un filtre d'intention correspondant est lancée lorsqu'un utilisateur clique sur la notification.
Signature:
clickAction?: string;
AndroidNotification.color
Couleur de l’icône de notification au format #rrggbb
.
Signature:
color?: string;
AndroidNotification.defaultLightSettings
Si défini sur true
, utilisez les paramètres d'éclairage LED par défaut du framework Android pour la notification. Les valeurs par défaut sont spécifiées dans config.xml . Si default_light_settings
est défini sur true
et light_settings
est également défini, le light_settings
spécifié par l'utilisateur est utilisé à la place de la valeur par défaut.
Signature:
defaultLightSettings?: boolean;
AndroidNotification.defaultSound
Si défini sur true
, utilisez le son par défaut du framework Android pour la notification. Les valeurs par défaut sont spécifiées dans config.xml .
Signature:
defaultSound?: boolean;
AndroidNotification.defaultVibrateTimings
Si défini sur true
, utilisez le modèle de vibration par défaut du framework Android pour la notification. Les valeurs par défaut sont spécifiées dans config.xml . Si default_vibrate_timings
est défini sur true
et vibrate_timings
est également défini, la valeur par défaut est utilisée à la place de vibrate_timings
spécifié par l'utilisateur. .
Signature:
defaultVibrateTimings?: boolean;
AndroidNotification.eventTimestamp
Pour les notifications qui informent les utilisateurs sur des événements avec une référence temporelle absolue, définit l'heure à laquelle l'événement dans la notification s'est produit. Les notifications dans le panneau sont triées selon cette heure.
Signature:
eventTimestamp?: Date;
AndroidNotification.icon
Ressource d'icône pour la notification Android.
Signature:
icon?: string;
AndroidNotification.imageUrl
URL d'une image à afficher dans la notification.
Signature:
imageUrl?: string;
AndroidNotification.lightSettings
Paramètres permettant de contrôler le taux de clignotement et la couleur de la LED de notification si la LED est disponible sur l'appareil. Le temps de clignotement total est contrôlé par le système d'exploitation.
Signature:
lightSettings?: LightSettings;
AndroidNotification.localOnly
Définit si cette notification concerne uniquement l'appareil actuel. Certaines notifications peuvent être reliées à d'autres appareils pour un affichage à distance, comme une montre Wear OS. Cet indice peut être défini pour recommander que cette notification ne soit pas pontée. Consultez les guides Wear OS .
Signature:
localOnly?: boolean;
AndroidNotification.notificationCount
Définit le nombre d’éléments représentés par cette notification. Peut être affiché sous forme de nombre de badges pour les lanceurs prenant en charge les badges. Voir NotificationBadge . Par exemple, cela peut être utile si vous utilisez une seule notification pour représenter plusieurs nouveaux messages mais que vous souhaitez que le nombre ici représente le nombre total de nouveaux messages. S'il est nul ou non spécifié, les systèmes prenant en charge les badges utilisent la valeur par défaut, qui consiste à incrémenter un nombre affiché dans le menu enfoncé à chaque fois qu'une nouvelle notification arrive.
Signature:
notificationCount?: number;
AndroidNotification.priority
Définit la priorité relative de cette notification. Les notifications de faible priorité peuvent être masquées à l'utilisateur dans certaines situations. Notez que cette priorité diffère de AndroidMessagePriority
. Cette priorité est traitée par le client après la remise du message. Alors AndroidMessagePriority
est un concept FCM qui contrôle le moment où le message est remis.
Signature:
priority?: ('min' | 'low' | 'default' | 'high' | 'max');
AndroidNotification.sound
Nom de fichier du son à jouer lorsque l'appareil reçoit la notification.
Signature:
sound?: string;
AndroidNotification.sticky
Lorsqu'elle est définie sur false
ou non définie, la notification est automatiquement ignorée lorsque l'utilisateur clique dessus dans le panneau. Lorsqu'il est défini sur true
, la notification persiste même lorsque l'utilisateur clique dessus.
Signature:
sticky?: boolean;
AndroidNotification.tag
Balise de notification. Il s'agit d'un identifiant utilisé pour remplacer les notifications existantes dans le tiroir de notifications. Si non spécifié, chaque demande crée une nouvelle notification.
Signature:
tag?: string;
AndroidNotification.ticker
Définit le texte du « ticker » qui est envoyé aux services d'accessibilité. Avant le niveau d'API 21 (Lollipop), définit le texte affiché dans la barre d'état lorsque la notification arrive pour la première fois.
Signature:
ticker?: string;
AndroidNotification.titre
Titre de la notification Android. Lorsqu'il est fourni, remplace le titre défini via admin.messaging.Notification
.
Signature:
title?: string;
AndroidNotification.titleLocArgs
Un tableau de clés de ressources qui seront utilisées à la place des spécificateurs de format dans titleLocKey
.
Signature:
titleLocArgs?: string[];
AndroidNotification.titleLocKey
Clé de la chaîne de titre dans la ressource chaîne de l'application à utiliser pour localiser le texte du titre.
Signature:
titleLocKey?: string;
AndroidNotification.vibrateTimingsMillis
Définit le modèle de vibration à utiliser. Passez quelques millisecondes pour allumer ou éteindre le vibrateur. La première valeur indique la durée à attendre avant d'allumer le vibreur. La valeur suivante indique la durée pendant laquelle le vibrateur reste allumé. Les valeurs suivantes alternent entre la durée pour éteindre le vibrateur et pour allumer le vibrateur. Si vibrate_timings
est défini et default_vibrate_timings
est défini sur true
, la valeur par défaut est utilisée à la place du vibrate_timings
spécifié par l'utilisateur .
Signature:
vibrateTimingsMillis?: number[];
AndroidNotification.visibilité
Définit la visibilité de la notification. Doit être soit private
, public
, ou secret
. Si non spécifié, la valeur par défaut est private
.
Signature:
visibility?: ('private' | 'public' | 'secret');