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

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

قبل البدء

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

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

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

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

"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. يمكنك استخدام API Explorer لإنشاء حمولة واختبارها.

"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. يمكنك استخدام API Explorer لإنشاء حمولة واختبارها.

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