أرسل صورة في حمولة الإخطار

تدعم واجهة برمجة تطبيقات FCM HTTP v1 ومؤلف الإشعارات إرسال روابط الصور في حمولة إشعار العرض، لتنزيل الصورة على الجهاز بعد التسليم. يقتصر حجم صور الإشعارات على 1 ميغابايت، ويتم تقييدها من خلال دعم صور Android الأصلي.

بناء طلب الإرسال

في طلب إرسال الإشعارات، قم بتعيين خيار AndroidConfig التالي:

notification.image يحتوي على عنوان URL للصورة

يرسل طلب الإرسال في المثال التالي عنوان إشعار مشتركًا إلى جميع الأنظمة الأساسية، ولكنه يرسل أيضًا صورة. فيما يلي تقدير تقريبي للتأثير المرئي على جهاز المستخدم:

رسم بسيط لصورة في إشعار العرض

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);
  });

استراحة

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

راجع الوثائق المرجعية لـ HTTP v1 للحصول على تفاصيل كاملة حول المفاتيح المتوفرة في الكتل الخاصة بالنظام الأساسي في نص الرسالة.

مع تعيين notification كما هو موضح، يمكّن طلب الإرسال هذا العميل المتلقي من التعامل مع الصورة التي تم تسليمها في الحمولة.