بدء استخدام "النشاط المباشر"

باستخدام Firebase Cloud Messaging واجهة برمجة تطبيقات HTTP v1، يمكنك إرسال إشعارات النشاط المباشر وتعديلها وإنهائها عن بُعد على أجهزة iOS. يُرجى العِلم أنّه يجب تثبيت الإصدار iOS 16.1 لاستخدام ميزة "الأنشطة المباشرة" والإصدار iOS 17.2 لبدء تنبيه بشأن نشاط مباشر عن بُعد.

قبل البدء

قبل بدء استخدام ميزة "النشاط المباشر" على Firebase Cloud Messaging، اتّبِع التعليمات الواردة في مقالة إعداد تطبيق عميل لخدمة "المراسلة عبر السحابة الإلكترونية من Firebase" على منصّات Apple لإنشاء Firebase Cloud Messaging وإضافته إلى تطبيق العميل.

بدء نشاط مباشر

لبدء نشاط مباشر عن بُعد باستخدام Firebase Cloud Messaging، عليك الحصول على رمز push-to-start من Apple. ستحتاج أيضًا إلى FCM تسجيل الرمز المميّز للتطبيق المستهدَف.

لإنشاء حمولة تبدأ نشاطًا مباشرًا، املأ حقل apns.payload من نموذج الرمز البرمجي التالي لبدء نشاط مباشر عن بُعد باستخدام FCM. يمكنك استخدام مستكشف واجهة برمجة التطبيقات لإنشاء الحمولة واختبارها.

"message":{
    "token": "<fcm_token:test>",
    "apns":{
      "live_activity_token": "<live_activity_push_to_start_token>",
      "headers":{
        "apns-priority": "10"
      },
      "payload":{
        "aps": {
          "timestamp": <timestamp>,
          "event": "start",
          "content-state": {
            "demo": 1
          },
          "attributes-type": "DemoAttributes",
          "attributes": {
            "demoAttribute": 1,
          },
          "alert": {
            "title": "test title",
            "body": "test body"
          }
        }
      }
    }
  }

تعديل نشاط مباشر

لتعديل نشاط مباشر عن بُعد باستخدام Firebase Cloud Messaging، عليك الحصول على رمز إشعال من Apple. ستحتاج أيضًا إلى FCM تسجيل الرمز المميّز للتطبيق المستهدَف.

لإنشاء حمولة تعدّل "نشاطًا مباشرًا"، املأ حقل apns.payload من نموذج الرمز البرمجي التالي لتعديل نشاط مباشر عن بُعد باستخدام FCM. يمكنك استخدام مستكشف واجهة برمجة التطبيقات لإنشاء الحمولة واختبارها.

"message":{
    "token": "<fcm_token:test>",
    "apns":{
      "live_activity_token": "<live_activity_push_token>",
      "headers":{
        "apns-priority": "10"
      },
      "payload":{
        "aps": {
          "timestamp": <timestamp>,
          "event": "update",
          "content-state": {
            "test1": 100,
            "test2": "demo"
          },
          "alert": {
            "title": "test title",
            "body": "test body"
          }
        }
      }
    }
  }
}

إنهاء نشاط مباشر

لإنهاء نشاط مباشر باستخدام Firebase Cloud Messaging، يجب الحصول على رمز مميّز فوري من Apple. ستحتاج أيضًا إلى FCM تسجيل الرمز المميّز للتطبيق المستهدَف.

لإنشاء حمولة تنهي نشاطًا مباشرًا، املأ الحقل apns.payload من نموذج الرمز التالي لإنهاء نشاط مباشر عن بُعد باستخدام FCM. يمكنك استخدام مستكشف واجهة برمجة التطبيقات لإنشاء الحمولة واختبارها.

"message":{
     "token": "<fcm_token:test>",
    "apns":{
      "live_activity_token": "<live_activity_push_token>",
      "headers":{
        "apns-priority": "10"
      },
      "payload":{
        "aps": {
          "timestamp": <timestamp>,
          "dismissal-date": <dismissal_date>,
          "event": "end",
          "content-state": {
            "test1": 100,
            "test2": "demo"
          },
          "alert": {
            "title": "test title",
            "body": "test body"
          }
        }
      }
    }
  }
}