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

باستخدام Firebase Cloud Messaging واجهة برمجة التطبيقات HTTP v1 ، يمكنك إرسال إشعارات "النشاط المباشر" وتعديلها وإيقافها عن بُعد على أجهزة 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

تشغيل

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