إرسال صورة ضمن حمولة الإشعارات

تتيح واجهة برمجة التطبيقات 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);
  });

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

راجِع المستند المرجعي لإصدار HTTP 1 للحصول على التفاصيل الكاملة حول المفاتيح المتاحة في الأقسام الخاصة بالمنصة في نص الرسالة.

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