تتيح واجهة برمجة التطبيقات FCM HTTP v1 وأداة إنشاء الإشعارات إرسال روابط الصور في حمولة إشعار العرض، وذلك لتنزيل الصورة على الجهاز بعد تسليمها. يقتصر حجم الصور المستخدَمة في الإشعارات على 1 ميغابايت، ويتم حظرها بخلاف ذلك بموجب إمكانية عرض الصور المضمّنة في نظام Android.
إنشاء طلب الإرسال
في طلب إرسال الإشعارات، اضبط خيار AndroidConfig التالي:
-
notification.image
الذي يحتوي على عنوان URL الخاص بالصورة
يرسل طلب الإرسال التالي عنوان إشعار شائعًا إلى جميع الأنظمة الأساسية، ولكنّه يرسل أيضًا صورة. في ما يلي مثال على التأثير المرئي على جهاز المستخدم:
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
على النحو الموضّح، يتيح طلب الإرسال هذا للعميل المستلِم
التعامل مع الصورة التي تم تسليمها في الحمولة.