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

واجهة برمجة التطبيقات FCM HTTP v1 مؤلف الإشعارات إتاحة إرسال روابط صور في حمولة شاشة العرض لتنزيل الصور على الجهاز بعد تسليمها. وتتيح هذه الوظيفة استخدام كل من الصور والفيديوهات لتطبيقات Apple. (راجع وثائق Apple للتعرف على حدود حجم الملف).

لتتمكّن من تلقّي صور الإشعارات ومعالجتها في تطبيق Apple، يجب إضافة إضافة خدمة الإشعارات تسمح إضافة خدمة الإشعارات لتطبيقك بمعالجة الصورة قبل عرض الإشعار للمستخدم النهائي في حمولة "المراسلة عبر السحابة الإلكترونية من Firebase"

إعداد إضافة خدمة الإشعارات

لإدراج إضافة خدمة، عليك تنفيذ مهام الإعداد المطلوبة تعديل الإشعارات وعرضها في أسماء نقاط الوصول (APN)، ثم إدراج واجهة برمجة التطبيقات مساعد إضافة "المراسلة عبر السحابة الإلكترونية من Firebase" في NotificationService.m. على وجه التحديد، بدلاً من إكمال معاودة الاتصال باستخدام self.contentHandler(self.bestAttemptContent);, أكمله بـ FIRMessaging extensionHelper كما هو موضح:

@interface NotificationService () <NSURLSessionDelegate>
@property(nonatomic) void (^contentHandler)(UNNotificationContent *contentToDeliver);
@property(nonatomic) UNMutableNotificationContent *bestAttemptContent;
@end

@implementation NotificationService

- (void)didReceiveNotificationRequest:(UNNotificationRequest *)request withContentHandler:(void (^)(UNNotificationContent * _Nonnull))contentHandler {
    self.contentHandler = contentHandler;
    self.bestAttemptContent = [request.content mutableCopy];

    // Modify the notification content here as you wish
    self.bestAttemptContent.title = [NSString stringWithFormat:@"%@ [modified]",
    self.bestAttemptContent.title];

  // Call FIRMessaging extension helper API.
  [[FIRMessaging extensionHelper] populateNotificationContent:self.bestAttemptContent
                                            withContentHandler:contentHandler];

}
...

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

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

• ورقة البيانات "fcm_options.image" التي تحتوي على عنوان URL للصورة
• headers({ "mutable-content": 1})

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

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

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

عند ضبط السمة mutable-content على أنّها معروضة، يؤدّي طلب الإرسال هذا إلى تفعيل الخدمة. الإضافة على جهاز العميل المستلِم للتعامل مع الصورة المرسَلة في الحمولة.