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

باستخدام 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.

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

تشغيل

انقر على تنفيذ لتجربة العيّنة في API Explorer.

تعديل نشاط حي

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

تشغيل

انقر على تنفيذ لتجربة العيّنة في API Explorer.

إنهاء نشاط 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

تشغيل

انقر على تنفيذ لتجربة العيّنة في API Explorer.