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

تتيح واجهة برمجة التطبيقات 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 كما هو موضّح، يتيح طلب الإرسال هذا للجهاز المستلِم معالجة الصورة التي تم إرسالها في الحمولة.