NotificationMessagePayload interface

Interfaccia che rappresenta un payload del messaggio di notifica dell'API legacy FCM. I messaggi di notifica consentono agli sviluppatori di inviare fino a 4 KB di coppie chiave-valore predefinite. Le chiavi accettate sono descritte di seguito.

Vedi Compilare richieste di invio per esempi di codice e documentazione dettagliata.

Firma:

export interface NotificationMessagePayload 

Proprietà

Proprietà Tipo Descrizione
distintivo corda Il valore del badge sull'icona dell'app nella schermata iniziale. Se non specificato il badge non viene modificato. Se impostato a 0 il badge viene rimosso. **Piattaforme:** iOS
corpo corda Il corpo del testo della notifica. **Piattaforme:** iOS, Android, Web
bodyLocArgs corda Valori di stringa variabili da utilizzare al posto degli identificatori di formato in body_loc_key da utilizzare per localizzare il corpo del testo nella localizzazione corrente dell'utente. Il valore deve essere un array JSON stringato. **iOS:** corrisponde a loc-args nel payload APN. Per ulteriori informazioni, consulta Riferimento alla chiave del payload e Localizzazione del contenuto delle notifiche remote . **Android:** consulta Formattazione e stile per ulteriori informazioni. **Piattaforme:** iOS, Android
bodyLocKey corda Chiave della stringa del corpo nelle risorse stringa dell'app da utilizzare per localizzare il corpo del testo nella localizzazione corrente dell'utente. **iOS:** corrisponde a loc-key nel payload APN. Per ulteriori informazioni, consulta Riferimento alla chiave del payload e Localizzazione del contenuto delle notifiche remote . **Android:** consulta Risorse sulle stringhe per ulteriori informazioni. **Piattaforme:** iOS, Android
fare clic suAzione corda Azione associata al clic di un utente sulla notifica. Se specificato, viene avviata un'attività con un filtro intento corrispondente quando un utente fa clic sulla notifica. * **Piattaforme:** Android
colore corda Il colore dell'icona di notifica, espresso nel formato #rrggbb . **Piattaforme:** Android
icona corda L'icona della notifica. **Android:** imposta l'icona di notifica su myicon per la risorsa disegnabile myicon . Se non invii questa chiave nella richiesta, FCM visualizza l'icona di avvio specificata nel manifest dell'app. **Web:** l'URL da utilizzare per l'icona della notifica. **Piattaforme:** Android, Web
suono corda Il suono da riprodurre quando il dispositivo riceve una notifica. Supporta "predefinito" per il suono di notifica predefinito del dispositivo o il nome file di una risorsa audio inclusa nell'app. I file audio devono risiedere in /res/raw/ . **Piattaforme:** Android
etichetta corda Identificatore utilizzato per sostituire le notifiche esistenti nel cassetto delle notifiche. Se non specificato, ogni richiesta crea una nuova notifica. Se specificato ed è già visualizzata una notifica con lo stesso tag, la nuova notifica sostituisce quella esistente nel cassetto delle notifiche. **Piattaforme:** Android
titolo corda Il titolo della notifica. **Piattaforme:** iOS, Android, Web
titoloLocArgs corda Valori di stringa variabili da utilizzare al posto degli identificatori di formato in title_loc_key da utilizzare per localizzare il testo del titolo nella localizzazione corrente dell'utente. Il valore deve essere un array JSON stringato. **iOS:** corrisponde a title-loc-args nel payload APN. Per ulteriori informazioni, consulta Riferimento alla chiave del payload e Localizzazione del contenuto delle notifiche remote . **Android:** consulta Formattazione e stile per ulteriori informazioni. **Piattaforme:** iOS, Android
titoloLocKey corda Chiave della stringa del titolo nelle risorse stringa dell'app da utilizzare per localizzare il testo del titolo nella localizzazione corrente dell'utente. **iOS:** corrisponde alla title-loc-key nel payload APN. Per ulteriori informazioni, consulta Riferimento alla chiave del payload e Localizzazione del contenuto delle notifiche remote . **Android:** consulta Risorse sulle stringhe per ulteriori informazioni. **Piattaforme:** iOS, Android

NotificationMessagePayload.badge

Il valore del badge sull'icona dell'app nella schermata iniziale.

Se non specificato il badge non viene modificato.

Se impostato su 0 , il badge viene rimosso.

**Piattaforme:** iOS

Firma:

badge?: string;

NotificationMessagePayload.body

Il corpo del testo della notifica.

**Piattaforme:** iOS, Android, Web

Firma:

body?: string;

NotificationMessagePayload.bodyLocArgs

Valori di stringa variabili da utilizzare al posto degli identificatori di formato in body_loc_key da utilizzare per localizzare il corpo del testo nella localizzazione corrente dell'utente.

Il valore deve essere un array JSON stringato.

**iOS:** corrisponde a loc-args nel payload APN. Per ulteriori informazioni, consulta Riferimento alla chiave del payload e Localizzazione del contenuto delle notifiche remote .

**Android:** consulta Formattazione e stile per ulteriori informazioni.

**Piattaforme:** iOS, Android

Firma:

bodyLocArgs?: string;

NotificationMessagePayload.bodyLocKey

Chiave della stringa del corpo nelle risorse stringa dell'app da utilizzare per localizzare il corpo del testo nella localizzazione corrente dell'utente.

**iOS:** corrisponde a loc-key nel payload APN. Per ulteriori informazioni, consulta Riferimento alla chiave del payload e Localizzazione del contenuto delle notifiche remote .

**Android:** consulta Risorse sulle stringhe per ulteriori informazioni.

**Piattaforme:** iOS, Android

Firma:

bodyLocKey?: string;

NotificationMessagePayload.clickAction

Azione associata al clic di un utente sulla notifica. Se specificato, viene avviata un'attività con un filtro intento corrispondente quando un utente fa clic sulla notifica.

* **Piattaforme:** Android

Firma:

clickAction?: string;

NotificationMessagePayload.color

Il colore dell'icona di notifica, espresso nel formato #rrggbb .

**Piattaforme:** Android

Firma:

color?: string;

NotificationMessagePayload.icon

L'icona della notifica.

**Android:** imposta l'icona di notifica su myicon per la risorsa disegnabile myicon . Se non invii questa chiave nella richiesta, FCM visualizza l'icona di avvio specificata nel manifest dell'app.

**Web:** l'URL da utilizzare per l'icona della notifica.

**Piattaforme:** Android, Web

Firma:

icon?: string;

NotificationMessagePayload.sound

Il suono da riprodurre quando il dispositivo riceve una notifica. Supporta "predefinito" per il suono di notifica predefinito del dispositivo o il nome file di una risorsa audio inclusa nell'app. I file audio devono risiedere in /res/raw/ .

**Piattaforme:** Android

Firma:

sound?: string;

NotificationMessagePayload.tag

Identificatore utilizzato per sostituire le notifiche esistenti nel cassetto delle notifiche.

Se non specificato, ogni richiesta crea una nuova notifica.

Se specificato ed è già visualizzata una notifica con lo stesso tag, la nuova notifica sostituisce quella esistente nel cassetto delle notifiche.

**Piattaforme:** Android

Firma:

tag?: string;

NotificationMessagePayload.title

Il titolo della notifica.

**Piattaforme:** iOS, Android, Web

Firma:

title?: string;

NotificationMessagePayload.titleLocArgs

Valori di stringa variabili da utilizzare al posto degli identificatori di formato in title_loc_key da utilizzare per localizzare il testo del titolo nella localizzazione corrente dell'utente.

Il valore deve essere un array JSON stringato.

**iOS:** corrisponde a title-loc-args nel payload APN. Per ulteriori informazioni, consulta Riferimento alla chiave del payload e Localizzazione del contenuto delle notifiche remote .

**Android:** consulta Formattazione e stile per ulteriori informazioni.

**Piattaforme:** iOS, Android

Firma:

titleLocArgs?: string;

NotificationMessagePayload.titleLocKey

Chiave della stringa del titolo nelle risorse stringa dell'app da utilizzare per localizzare il testo del titolo nella localizzazione corrente dell'utente.

**iOS:** corrisponde alla title-loc-key nel payload APN. Per ulteriori informazioni, consulta Riferimento alla chiave del payload e Localizzazione del contenuto delle notifiche remote .

**Android:** consulta Risorse sulle stringhe per ulteriori informazioni.

**Piattaforme:** iOS, Android

Firma:

titleLocKey?: string;