Interfejs API FCM HTTP w wersji 1 i Edytor powiadomień obsługują wysyłanie linków do obrazów w danych ładunku powiadomienia wyświetlanego, aby umożliwić pobieranie obrazów na urządzenie po ich dostarczeniu. Rozmiar obrazów w powiadomieniach jest ograniczony do 1 MB, a w innych przypadkach ogranicza go natywny obsługa obrazów w Androidzie.
Tworzenie żądania wysyłania
W prośbie o wysłanie powiadomienia ustaw opcję AndroidConfig:
notification.image
zawierający adres URL obrazu
W tym przykładzie żądanie wysyłania zawiera wspólny tytuł powiadomienia na wszystkich platformach, ale także obraz. Oto przybliżony efekt wizualny na urządzeniu użytkownika:
Node.js
const topicName = 'industry-tech';
const message = {
notification: {
title: 'Sparky says hello!'
},
android: {
notification: {
imageUrl: 'https://foo.bar.pizza-monster.png'
}
},
apns: {
payload: {
aps: {
'mutable-content': 1
}
},
fcm_options: {
image: 'https://foo.bar.pizza-monster.png'
}
},
webpush: {
headers: {
image: 'https://foo.bar.pizza-monster.png'
}
},
topic: topicName,
};
getMessaging().send(message)
.then((response) => {
// Response is a message ID string.
console.log('Successfully sent message:', response);
})
.catch((error) => {
console.log('Error sending message:', error);
});
REST
POST https://fcm.googleapis.com/v1/projects/myproject-b5ae1/messages:send HTTP/1.1
Content-Type: application/json
Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA
{
"message":{
"topic":"industry-tech",
"notification":{
"title":"Sparky says hello!",
},
"android":{
"notification":{
"image":"https://foo.bar/pizza-monster.png"
}
},
"apns":{
"payload":{
"aps":{
"mutable-content":1
}
},
"fcm_options": {
"image":"https://foo.bar/pizza-monster.png"
}
},
"webpush":{
"headers":{
"image":"https://foo.bar/pizza-monster.png"
}
}
}
}
Pełne informacje o kluczach dostępnych w blokach związanych z konkretną platformą w treści wiadomości znajdziesz w dokumentacji referencyjnej HTTP w wersji 1.
Gdy notification
jest ustawiony tak, jak pokazano na ilustracji, to żądanie wysyłania umożliwia klientowi odbiorczemu obsługę obrazu dostarczonego w danych ładunku.