MessagingOptions interface

Interfaz que representa las opciones que se pueden proporcionar al enviar un mensaje a través de las API heredadas de FCM.

Consulte Crear solicitudes de envío para obtener ejemplos de código y documentación detallada.

Firma:

export interface MessagingOptions 

Propiedades

Propiedad Escribe Descripción
colapsar clave cuerda Cadena que identifica un grupo de mensajes (por ejemplo, "Actualizaciones disponibles") que se pueden contraer, de modo que solo se envíe el último mensaje cuando se pueda reanudar la entrega. Esto se usa para evitar enviar demasiados mensajes iguales cuando el dispositivo vuelve a estar en línea o se activa. No hay garantía del orden en que se envían los mensajes. Se permite un máximo de cuatro claves de contracción diferentes en un momento dado. Esto significa que el servidor FCM puede almacenar simultáneamente cuatro mensajes de envío a sincronización diferentes por aplicación cliente. Si excede este número, no hay garantía de qué cuatro claves de colapso conservará el servidor de FCM. **Valor predeterminado:** Ninguno
contenidoDisponible booleano En iOS, use este campo para representar content-available en la carga útil de APN. Cuando se envía una notificación o un mensaje de datos y se establece en true , se activa una aplicación cliente inactiva. En Android, los mensajes de datos activan la aplicación de forma predeterminada. En Chrome, esta bandera actualmente no es compatible. **Valor predeterminado:** false
ejecutar en seco booleano Si el mensaje debe enviarse o no. Cuando se establece en true , permite a los desarrolladores probar una solicitud sin enviar un mensaje. Cuando se establece en false , se enviará el mensaje. **Valor predeterminado:** false
contenido mutable booleano En iOS, use este campo para representar mutable-content en la carga útil de APN. Cuando se envía una notificación y se establece en true , el contenido de la notificación se puede modificar antes de que se muestre, mediante una extensión de la aplicación del Servicio de notificaciones. . En Android y Web, este parámetro se ignorará. **Valor predeterminado:** false
prioridad cuerda La prioridad del mensaje. Los valores válidos son "normal" y "high". En iOS, estos corresponden a las prioridades 5 y 10 de APN. De forma predeterminada, los mensajes de notificación se envían con prioridad alta y los mensajes de datos se envían con prioridad normal. La prioridad normal optimiza el consumo de batería de la aplicación del cliente y debe usarse a menos que se requiera una entrega inmediata. Para mensajes con prioridad normal, la aplicación puede recibir el mensaje con un retraso no especificado. Cuando se envía un mensaje con alta prioridad, se envía de inmediato y la aplicación puede activar un dispositivo inactivo y abrir una conexión de red a su servidor. Para obtener más información, consulte Configuración de la prioridad de un mensaje . **Valor predeterminado:** "high" para mensajes de notificación, "normal" para mensajes de datos
Nombre del paquete restringido cuerda El nombre del paquete de la aplicación con el que deben coincidir los tokens de registro para recibir el mensaje. **Valor predeterminado:** Ninguno
tiempo para vivir número Cuánto tiempo (en segundos) se debe mantener el mensaje en el almacenamiento de FCM si el dispositivo está fuera de línea. El tiempo máximo de vida admitido es de cuatro semanas y el valor predeterminado también es de cuatro semanas. Para obtener más información, consulte Configuración de la vida útil de un mensaje . **Valor predeterminado:** 2419200 (que representa cuatro semanas, en segundos)

MessagingOptions.collapseKey

Cadena que identifica un grupo de mensajes (por ejemplo, "Actualizaciones disponibles") que se pueden contraer, de modo que solo se envíe el último mensaje cuando se pueda reanudar la entrega. Esto se usa para evitar enviar demasiados mensajes iguales cuando el dispositivo vuelve a estar en línea o se activa.

No hay garantía del orden en que se envían los mensajes.

Se permite un máximo de cuatro claves de contracción diferentes en un momento dado. Esto significa que el servidor FCM puede almacenar simultáneamente cuatro mensajes de envío a sincronización diferentes por aplicación cliente. Si excede este número, no hay garantía de qué cuatro claves de colapso conservará el servidor de FCM.

**Valor predeterminado:** Ninguno

Firma:

collapseKey?: string;

MessagingOptions.contentAvailable

En iOS, use este campo para representar content-available en la carga útil de APN. Cuando se envía una notificación o un mensaje de datos y se establece en true , se despierta una aplicación cliente inactiva. En Android, los mensajes de datos activan la aplicación de forma predeterminada. En Chrome, esta bandera actualmente no es compatible.

**Valor predeterminado:** false

Firma:

contentAvailable?: boolean;

MessagingOptions.dryRun

Si el mensaje debe enviarse o no. Cuando se establece en true , permite a los desarrolladores probar una solicitud sin enviar un mensaje. Cuando se establece en false , se enviará el mensaje.

**Valor predeterminado:** false

Firma:

dryRun?: boolean;

MessagingOptions.mutableContent

En iOS, use este campo para representar mutable-content en la carga útil de APN. Cuando se envía una notificación y se establece en true , el contenido de la notificación se puede modificar antes de que se muestre mediante una extensión de la aplicación del Servicio de notificaciones .

En Android y Web, este parámetro se ignorará.

**Valor predeterminado:** false

Firma:

mutableContent?: boolean;

MessagingOptions.priority

La prioridad del mensaje. Los valores válidos son "normal" y "high". En iOS, estos corresponden a las prioridades 5 y 10 de APN .

De forma predeterminada, los mensajes de notificación se envían con prioridad alta y los mensajes de datos se envían con prioridad normal. La prioridad normal optimiza el consumo de batería de la aplicación del cliente y debe usarse a menos que se requiera una entrega inmediata. Para mensajes con prioridad normal, la aplicación puede recibir el mensaje con un retraso no especificado.

Cuando se envía un mensaje con alta prioridad, se envía de inmediato y la aplicación puede activar un dispositivo inactivo y abrir una conexión de red a su servidor.

Para obtener más información, consulte Configuración de la prioridad de un mensaje .

**Valor predeterminado:** "high" para mensajes de notificación, "normal" para mensajes de datos

Firma:

priority?: string;

MessagingOptions.restrictedPackageName

El nombre del paquete de la aplicación con el que deben coincidir los tokens de registro para recibir el mensaje.

**Valor predeterminado:** Ninguno

Firma:

restrictedPackageName?: string;

MessagingOptions.timeToLive

Cuánto tiempo (en segundos) se debe mantener el mensaje en el almacenamiento de FCM si el dispositivo está fuera de línea. El tiempo máximo de vida admitido es de cuatro semanas y el valor predeterminado también es de cuatro semanas. Para obtener más información, consulte Configuración de la vida útil de un mensaje .

**Valor predeterminado:** 2419200 (que representa cuatro semanas, en segundos)

Firma:

timeToLive?: number;