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

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

قبل البدء

قبل البدء في استخدام ميزة "النشاط المباشر" على 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

الجري

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

تعديل نشاط Live

لتعديل نشاط مباشر عن بُعد باستخدام 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

الجري

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

إنهاء نشاط Live

لإنهاء نشاط مباشر باستخدام 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

الجري

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