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

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

قبل البدء

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

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

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

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

REST

{
"message": {
  "token": "FCM_TOKEN",
  "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"
        }
      }
    }
  }
}
}

cURL

curl -X POST -H "Authorization: Bearer OAUTH2_ACCESS_TOKEN" -H "Content-Type: application/json" -d '{
"message": {
"token": "FCM_TOKEN",
"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"
      }
    }
  }
}
}
}' https://fcm.googleapis.com/v1/projects/YOUR_PROJECT_ID/messages:send

الجري

انقر على تشغيل لتجربة النموذج في مستكشف واجهات برمجة التطبيقات.

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

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

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

REST

{
"message": {
  "token": "FCM_TOKEN",
  "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"
        }
      }
    }
  }
}
}

cURL

curl -X POST -H "Authorization: Bearer OAUTH2_ACCESS_TOKEN" -H "Content-Type: application/json" -d '{
"message": {
"token": "FCM_TOKEN",
"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"
      }
    }
  }
}
}
}' https://fcm.googleapis.com/v1/projects/YOUR_PROJECT_ID/messages:send

الجري

انقر على تشغيل لتجربة النموذج في مستكشف واجهات برمجة التطبيقات.

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

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

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

REST

{
"message": {
  "token": "FCM_TOKEN",
  "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"
        }
      }
    }
  }
}
}

cURL

curl -X POST -H "Authorization: Bearer OAUTH2_ACCESS_TOKEN" -H "Content-Type: application/json" -d '{
"message": {
"token": "FCM_TOKEN",
"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"
      }
    }
  }
}
}
}' https://fcm.googleapis.com/v1/projects/YOUR_PROJECT_ID/messages:send

الجري

انقر على تشغيل لتجربة النموذج في مستكشف واجهات برمجة التطبيقات.