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

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

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

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

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

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

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

Node.jsREST
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 الإصدار 1 للحصول على تفاصيل أكثر حول المفاتيح المتاحة في الأقسام الخاصة بالمنصة في نص الرسالة.

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