Interfaz que representa la carga útil de un mensaje de notificación de la API heredada de FCM. Los mensajes de notificación permiten a los desarrolladores enviar hasta 4 KB de pares clave-valor predefinidos. Las claves aceptadas se describen a continuación.
Consulta Cómo compilar solicitudes de envío para ver muestras de código y documentación detallada.
Firma:
export interface NotificationMessagePayload
Propiedades
Propiedad | Tipo | Descripción |
---|---|---|
insignia | string | El valor de la insignia en el ícono de la app de la pantalla principal.Si no se especifica, no se modifica la insignia.Si se establece en 0 , se quita la insignia.**Plataformas:** iOS |
cuerpo | string | El texto del cuerpo de la notificación.**Plataformas:** iOS, Android y la Web |
bodyLocArgs; | string | Valores de cadena variables que se usarán en lugar de los especificadores de formato en body_loc_key para localizar el texto del cuerpo en la localización actual del usuario.El valor debe ser un array JSON en cadena.**iOS:** Corresponde a loc-args en la carga útil de APNS. Para obtener más información, consulta Referencia de la clave de carga útil y Cómo localizar el contenido de las notificaciones remotas.**Android:** Consulta Formato y estilo para obtener más información.**Plataformas:** iOS y Android |
bodyLocKey | string | La clave de la cadena del cuerpo en los recursos de cadenas de la app que se usa para localizar el texto del cuerpo según la localización actual del usuario.**iOS:** Corresponde a loc-key en la carga útil de APNS. Para obtener más información, consulta Referencia de la clave de carga útil y Cómo localizar el contenido de las notificaciones remotas.**Android:** Consulta los Recursos de cadenas para obtener más información.**Plataformas:** iOS y Android |
clickAction | string | La acción asociada con el clic de un usuario en la notificación. Si se especifica, se lanza una actividad con un filtro de intents que coincide cuando un usuario hace clic en la notificación.* **Plataformas:** Android |
color | string | El color del ícono de notificación, expresado en formato #rrggbb .**Plataformas:** Android |
ícono | string | El ícono de la notificación.**Android:** Establece el ícono de notificación en myicon para el recurso de elementos de diseño myicon . Si no envías esta clave en la solicitud, FCM muestra el ícono de selector especificado en el manifiesto de tu app.**Web:** La URL que se debe usar para el ícono de la notificación.**Plataformas:** Android y la Web |
sonido | string | El sonido que se reproducirá cuando el dispositivo reciba una notificación. Admite la configuración predeterminada para el sonido de notificación predeterminado del dispositivo o el nombre de archivo de un recurso de sonido incluido en la app. Los archivos de sonido deben encontrarse en /res/raw/ .**Plataformas:** Android |
etiqueta | string | Identificador que se usa para reemplazar las notificaciones existentes en el panel lateral de notificaciones.Si no se especifica, cada solicitud crea una notificación nueva.Si se especifica y ya se muestra una notificación con la misma etiqueta, la nueva notificación reemplaza la existente en el panel lateral de notificaciones.**Plataformas:** Android |
title | string | El título de la notificación.**Plataformas:** iOS, Android y la Web |
titleLocArgs | string | Valores de cadena variables que se usarán en lugar de los especificadores de formato en title_loc_key para localizar el texto del título en la localización actual del usuario.El valor debe ser un array JSON en cadena.**iOS:** Corresponde a title-loc-args en la carga útil de APNS. Para obtener más información, consulta Referencia de la clave de carga útil y Cómo localizar el contenido de las notificaciones remotas.**Android:** Consulta Formato y estilo para obtener más información.**Plataformas:** iOS y Android |
titleLocKey | string | La clave de la cadena del título en los recursos de cadenas de la app que se usa para localizar el texto del título según la localización actual del usuario.**iOS:** Corresponde a title-loc-key en la carga útil de APNS. Para obtener más información, consulta Referencia de la clave de carga útil y Cómo localizar el contenido de las notificaciones remotas.**Android:** Consulta los Recursos de cadenas para obtener más información.**Plataformas:** iOS y Android |
NotificationMessagePayload.Badge
El valor de la insignia en el ícono de la app de la pantalla principal.
Si no se especifica, no se cambia la insignia.
Si se le asigna el valor 0
, la insignia se quita.
**Plataformas:** iOS
Firma:
badge?: string;
NotificationMessagePayload.body
El texto del cuerpo de la notificación.
**Plataformas:** iOS, Android y Web
Firma:
body?: string;
NotificationMessagePayload.bodyLocArgs
Valores de cadena variables que se usarán en lugar de los especificadores de formato en body_loc_key
para localizar el cuerpo del texto en la localización actual del usuario.
El valor debe ser un array JSON en cadena.
**iOS:** Corresponde a loc-args
en la carga útil de APNS. Para obtener más información, consulta Referencia de la clave de carga útil y Cómo localizar el contenido de las notificaciones remotas.
**Android:** Consulta Formato y estilo para obtener más información.
**Plataformas:** iOS y Android
Firma:
bodyLocArgs?: string;
NotificationMessagePayload.bodyLocKey
La clave de la cadena del cuerpo en los recursos de cadenas de la app que se usa para localizar el texto del cuerpo en la localización actual del usuario.
**iOS:** Corresponde a loc-key
en la carga útil de APNS. Para obtener más información, consulta Referencia de la clave de carga útil y Cómo localizar el contenido de las notificaciones remotas.
**Android:** Consulta Recursos de strings para obtener más información.
**Plataformas:** iOS y Android
Firma:
bodyLocKey?: string;
NotificationMessagePayload.clickAction
La acción asociada con el clic de un usuario en la notificación. Si se especifica, se lanza una actividad con un filtro de intents que coincide cuando un usuario hace clic en la notificación.
* **Plataformas:** Android
Firma:
clickAction?: string;
NotificationMessagePayload.color
El color del ícono de notificación, expresado en formato #rrggbb
.
**Plataformas:** Android
Firma:
color?: string;
NotificationMessagePayload.icon
El ícono de la notificación.
**Android:** Establece el ícono de notificación en myicon
para el recurso de elementos de diseño myicon
. Si no envías esta clave en la solicitud, FCM muestra el ícono de selector especificado en el manifiesto de la app.
**Web:** La URL que se usará para el ícono de la notificación.
**Plataformas:** Android y la Web
Firma:
icon?: string;
NotificationMessagePayload.sonido
El sonido que se reproducirá cuando el dispositivo reciba una notificación. Admite la configuración predeterminada para el sonido de notificación predeterminado del dispositivo o el nombre de archivo de un recurso de sonido incluido en la app. Los archivos de sonido deben encontrarse en /res/raw/
.
**Plataformas:** Android
Firma:
sound?: string;
NotificationMessagePayload.tag
Identificador que se usa para reemplazar las notificaciones existentes en el panel lateral de notificaciones.
Si no se configura, cada solicitud crea una nueva notificación.
Si se especifica y ya se muestra una notificación con la misma etiqueta, la nueva notificación reemplaza la existente en el panel lateral de notificaciones.
**Plataformas:** Android
Firma:
tag?: string;
NotificationMessagePayload.title
El título de la notificación.
**Plataformas:** iOS, Android y Web
Firma:
title?: string;
NotificationMessagePayload.titleLocArgs
Valores de cadena variables que se usarán en lugar de los especificadores de formato en title_loc_key
para localizar el título del texto en la localización actual del usuario.
El valor debe ser un array JSON en cadena.
**iOS:** Corresponde a title-loc-args
en la carga útil de APNS. Para obtener más información, consulta Referencia de la clave de carga útil y Cómo localizar el contenido de las notificaciones remotas.
**Android:** Consulta Formato y estilo para obtener más información.
**Plataformas:** iOS y Android
Firma:
titleLocArgs?: string;
NotificationMessagePayload.titleLocKey
La clave de la cadena del título en los recursos de cadenas de la app que se usa para localizar el texto del título según la localización actual del usuario.
**iOS:** Corresponde a title-loc-key
en la carga útil de APNS. Para obtener más información, consulta Referencia de la clave de carga útil y Cómo localizar el contenido de las notificaciones remotas.
**Android:** Consulta Recursos de strings para obtener más información.
**Plataformas:** iOS y Android
Firma:
titleLocKey?: string;