Wysyłanie obrazu w ładunku powiadomienia

Interfejs API FCM HTTP w wersji 1 i edytor powiadomień obsługują wysyłanie linków do obrazów w ładunku powiadomienia o wyświetlaniu w celu pobrania obrazu na urządzenie po dostarczeniu. Obrazy z powiadomieniami nie mogą być większe niż 1 MB. W innych przypadkach ogranicza ich natywna obsługa obrazów w Androidzie.

Tworzenie żądania wysłania

W żądaniu wysłania powiadomienia ustaw tę opcję AndroidConfig:

  • Pole notification.image zawierające adres URL obrazu

Poniższe przykładowe żądanie wysłania powoduje wysłanie wspólnego tytułu powiadomienia do wszystkich platform, ale powoduje też przesłanie obrazu. Oto szacowany wpływ wrażenia wizualnego na urządzenie użytkownika:

Prosty rysunek z obrazem w powiadomieniu o wyświetlaniu

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"
       }
     }
   }
 }

Szczegółowe informacje na temat kluczy dostępnych w blokach na poziomie platformy znajdziesz w treści wiadomości w dokumentacji referencyjnej HTTP w wersji 1.

Gdy notification jest ustawiony jak pokazano, to żądanie wysłania umożliwia klientowi odbierającego obsługę obrazu dostarczonego w ładunku.