Representa las opciones de notificación específicas de Android que se pueden incluir en AndroidConfig. .
Firma:
export interface AndroidNotification
Propiedades
Propiedad | Tipo | Descripción |
---|---|---|
cuerpo | cadena | Cuerpo de la notificación de Android. Cuando se proporciona, anula el cuerpo configurado a través de admin.messaging.Notification . |
cuerpoLocArgs | cadena[] | Una matriz de claves de recursos que se utilizarán en lugar de los especificadores de formato en bodyLocKey . |
cuerpoLocKey | cadena | Clave de la cadena del cuerpo en el recurso de cadena de la aplicación que se utilizará para localizar el texto del cuerpo. |
Canal ID | cadena | El ID del canal de notificaciones de Android (nuevo en Android O). La aplicación debe crear un canal con este ID de canal antes de poder recibir cualquier notificación con este ID de canal. Si no envía este ID de canal en la solicitud, o si la aplicación aún no ha creado el ID de canal proporcionado, FCM usa el ID de canal especificado en el manifiesto de la aplicación. |
hacer clic en acción | cadena | Acción asociada a que un usuario haga clic en la notificación. Si se especifica, se inicia una actividad con un filtro de intención coincidente cuando un usuario hace clic en la notificación. |
color | cadena | Color del icono de notificación en formato #rrggbb . |
configuración de luz predeterminada | booleano | Si se establece en true , use la configuración de luz LED predeterminada del marco de Android para la notificación. Los valores predeterminados se especifican en config.xml . Si default_light_settings se establece en true y light_settings también se establece, se utiliza light_settings especificado por el usuario en lugar del valor predeterminado. |
sonido predeterminado | booleano | Si se establece en true , use el sonido predeterminado del marco de Android para la notificación. Los valores predeterminados se especifican en config.xml . |
defaultVibrateTimings | booleano | Si se establece en true , use el patrón de vibración predeterminado del marco de Android para la notificación. Los valores predeterminados se especifican en config.xml . Si default_vibrate_timings se establece en true y vibrate_timings también se establece, se utiliza el valor predeterminado en lugar del vibrate_timings especificado por el usuario. |
eventoMarca de tiempo | Fecha | Para notificaciones que informan a los usuarios sobre eventos con una referencia de tiempo absoluta, establece la hora en que ocurrió el evento en la notificación. Las notificaciones en el panel están ordenadas por este tiempo. |
icono | cadena | Recurso de icono para la notificación de Android. |
URL de la imagen | cadena | URL de una imagen que se mostrará en la notificación. |
configuración de luz | Configuración de luz | Configuraciones para controlar la velocidad de parpadeo del LED de la notificación y el color si el LED está disponible en el dispositivo. El tiempo total de parpadeo lo controla el sistema operativo. |
solo locales | booleano | Establece si esta notificación es relevante o no solo para el dispositivo actual. Algunas notificaciones se pueden conectar a otros dispositivos para su visualización remota, como un reloj Wear OS. Esta sugerencia se puede configurar para recomendar que esta notificación no se puentee. Ver guías de Wear OS . |
notificaciónRecuento | número | Establece el número de elementos que representa esta notificación. Puede mostrarse como un recuento de insignias para los lanzadores que admiten insignias. Ver insignia de notificación . Por ejemplo, esto puede resultar útil si utiliza una sola notificación para representar varios mensajes nuevos, pero desea que el recuento aquí represente el número total de mensajes nuevos. Si es cero o no se especifica, los sistemas que admiten credenciales utilizan el valor predeterminado, que consiste en incrementar un número que se muestra en el menú de pulsación larga cada vez que llega una nueva notificación. |
prioridad | ('mínimo' | 'bajo' | 'predeterminado' | 'alto' | 'máximo') | Establece la prioridad relativa para esta notificación. Las notificaciones de baja prioridad pueden ocultarse al usuario en determinadas situaciones. Tenga en cuenta que esta prioridad difiere de AndroidMessagePriority . El cliente procesa esta prioridad una vez entregado el mensaje. Mientras que AndroidMessagePriority es un concepto de FCM que controla cuándo se entrega el mensaje. |
sonido | cadena | Nombre del archivo del sonido que se reproducirá cuando el dispositivo reciba la notificación. |
pegajoso | booleano | Cuando se establece en false o no se configura, la notificación se descarta automáticamente cuando el usuario hace clic en ella en el panel. Cuando se establece en true , la notificación persiste incluso cuando el usuario hace clic en ella. |
etiqueta | cadena | Etiqueta de notificación. Este es un identificador que se utiliza para reemplazar las notificaciones existentes en el cajón de notificaciones. Si no se especifica, cada solicitud crea una nueva notificación. |
corazón | cadena | Establece el texto del "ticker", que se envía a los servicios de accesibilidad. Antes del nivel API 21 (Lollipop), establece el texto que se muestra en la barra de estado cuando llega la notificación por primera vez. |
título | cadena | Título de la notificación de Android. Cuando se proporciona, anula el título establecido mediante admin.messaging.Notification . |
títuloLocArgs | cadena[] | Una matriz de claves de recursos que se utilizarán en lugar de los especificadores de formato en titleLocKey . |
títuloLocKey | cadena | Clave de la cadena de título en el recurso de cadena de la aplicación que se utilizará para localizar el texto del título. |
vibrarTiemposMillis | número[] | Establece el patrón de vibración que se utilizará. Pase una serie de milisegundos para encender o apagar el vibrador. El primer valor indica el tiempo que se debe esperar antes de encender el vibrador. El siguiente valor indica el tiempo que se mantendrá encendido el vibrador. Los valores posteriores alternan entre la duración para apagar y encender el vibrador. Si vibrate_timings está configurado y default_vibrate_timings está configurado en true , se utiliza el valor predeterminado en lugar del vibrate_timings especificado por el usuario. |
visibilidad | ('privado' | 'público' | 'secreto') | Establece la visibilidad de la notificación. Debe ser private , public o secret . Si no se especifica, el valor predeterminado es private . |
AndroidNotificación.cuerpo
Cuerpo de la notificación de Android. Cuando se proporciona, anula el cuerpo configurado a través de admin.messaging.Notification
.
Firma:
body?: string;
AndroidNotificación.bodyLocArgs
Una matriz de claves de recursos que se utilizarán en lugar de los especificadores de formato en bodyLocKey
.
Firma:
bodyLocArgs?: string[];
AndroidNotificación.bodyLocKey
Clave de la cadena del cuerpo en el recurso de cadena de la aplicación que se utilizará para localizar el texto del cuerpo.
Firma:
bodyLocKey?: string;
AndroidNotificación.channelId
El ID del canal de notificaciones de Android (nuevo en Android O). La aplicación debe crear un canal con este ID de canal antes de poder recibir cualquier notificación con este ID de canal. Si no envía este ID de canal en la solicitud, o si la aplicación aún no ha creado el ID de canal proporcionado, FCM usa el ID de canal especificado en el manifiesto de la aplicación.
Firma:
channelId?: string;
AndroidNotificación.clickAction
Acción asociada a que un usuario haga clic en la notificación. Si se especifica, se inicia una actividad con un filtro de intención coincidente cuando un usuario hace clic en la notificación.
Firma:
clickAction?: string;
AndroidNotificación.color
Color del icono de notificación en formato #rrggbb
.
Firma:
color?: string;
AndroidNotification.defaultLightSettings
Si se establece en true
, utilice la configuración de luz LED predeterminada del marco de Android para la notificación. Los valores predeterminados se especifican en config.xml . Si default_light_settings
se establece en true
y light_settings
también se establece, se utiliza light_settings
especificado por el usuario en lugar del valor predeterminado.
Firma:
defaultLightSettings?: boolean;
AndroidNotificación.defaultSound
Si se establece en true
, utilice el sonido predeterminado del marco de Android para la notificación. Los valores predeterminados se especifican en config.xml .
Firma:
defaultSound?: boolean;
AndroidNotification.defaultVibrateTimings
Si se establece en true
, utilice el patrón de vibración predeterminado del marco de Android para la notificación. Los valores predeterminados se especifican en config.xml . Si default_vibrate_timings
se establece en true
y vibrate_timings
también se establece, se utiliza el valor predeterminado en lugar de los vibrate_timings
especificados por el usuario. .
Firma:
defaultVibrateTimings?: boolean;
AndroidNotificación.eventTimestamp
Para notificaciones que informan a los usuarios sobre eventos con una referencia de tiempo absoluta, establece la hora en que ocurrió el evento en la notificación. Las notificaciones en el panel están ordenadas por este tiempo.
Firma:
eventTimestamp?: Date;
Icono de notificación de Android
Recurso de icono para la notificación de Android.
Firma:
icon?: string;
AndroidNotificación.imageUrl
URL de una imagen que se mostrará en la notificación.
Firma:
imageUrl?: string;
AndroidNotificación.lightConfiguración
Configuraciones para controlar la velocidad de parpadeo del LED de la notificación y el color si el LED está disponible en el dispositivo. El tiempo total de parpadeo lo controla el sistema operativo.
Firma:
lightSettings?: LightSettings;
AndroidNotificación.localOnly
Establece si esta notificación es relevante o no solo para el dispositivo actual. Algunas notificaciones se pueden conectar a otros dispositivos para su visualización remota, como un reloj Wear OS. Esta sugerencia se puede configurar para recomendar que esta notificación no se puentee. Ver guías de Wear OS .
Firma:
localOnly?: boolean;
AndroidNotificación.notificaciónCount
Establece el número de elementos que representa esta notificación. Puede mostrarse como un recuento de insignias para los lanzadores que admiten insignias. Ver insignia de notificación . Por ejemplo, esto puede resultar útil si utiliza una sola notificación para representar varios mensajes nuevos, pero desea que el recuento aquí represente el número total de mensajes nuevos. Si es cero o no se especifica, los sistemas que admiten credenciales utilizan el valor predeterminado, que consiste en incrementar un número que se muestra en el menú de pulsación larga cada vez que llega una nueva notificación.
Firma:
notificationCount?: number;
AndroidNotificación.prioridad
Establece la prioridad relativa para esta notificación. Las notificaciones de baja prioridad pueden ocultarse al usuario en determinadas situaciones. Tenga en cuenta que esta prioridad difiere de AndroidMessagePriority
. El cliente procesa esta prioridad una vez entregado el mensaje. Mientras que AndroidMessagePriority
es un concepto de FCM que controla cuándo se entrega el mensaje.
Firma:
priority?: ('min' | 'low' | 'default' | 'high' | 'max');
AndroidNotificación.sonido
Nombre del archivo del sonido que se reproducirá cuando el dispositivo reciba la notificación.
Firma:
sound?: string;
AndroidNotificación.sticky
Cuando se establece en false
o no se configura, la notificación se descarta automáticamente cuando el usuario hace clic en ella en el panel. Cuando se establece en true
, la notificación persiste incluso cuando el usuario hace clic en ella.
Firma:
sticky?: boolean;
Etiqueta de notificación de Android
Etiqueta de notificación. Este es un identificador que se utiliza para reemplazar las notificaciones existentes en el cajón de notificaciones. Si no se especifica, cada solicitud crea una nueva notificación.
Firma:
tag?: string;
AndroidNotificación.ticker
Establece el texto del "ticker", que se envía a los servicios de accesibilidad. Antes del nivel API 21 (Lollipop), establece el texto que se muestra en la barra de estado cuando llega la notificación por primera vez.
Firma:
ticker?: string;
AndroidNotificación.título
Título de la notificación de Android. Cuando se proporciona, anula el título establecido a través de admin.messaging.Notification
.
Firma:
title?: string;
AndroidNotificación.titleLocArgs
Una matriz de claves de recursos que se utilizarán en lugar de los especificadores de formato en titleLocKey
.
Firma:
titleLocArgs?: string[];
AndroidNotificación.titleLocKey
Clave de la cadena de título en el recurso de cadena de la aplicación que se utilizará para localizar el texto del título.
Firma:
titleLocKey?: string;
AndroidNotificación.vibrateTimingsMillis
Establece el patrón de vibración que se utilizará. Pase una serie de milisegundos para encender o apagar el vibrador. El primer valor indica el tiempo que se debe esperar antes de encender el vibrador. El siguiente valor indica el tiempo que se mantendrá encendido el vibrador. Los valores posteriores alternan entre la duración para apagar y encender el vibrador. Si vibrate_timings
está configurado y default_vibrate_timings
está configurado en true
, se utiliza el valor predeterminado en lugar de los vibrate_timings
especificados por el usuario. .
Firma:
vibrateTimingsMillis?: number[];
AndroidNotificación.visibilidad
Establece la visibilidad de la notificación. Debe ser private
, public
, o secret
. Si no se especifica, el valor predeterminado es private
.
Firma:
visibility?: ('private' | 'public' | 'secret');