با Firebase Cloud Messaging HTTP v1 API ، می‌توانید از راه دور اعلان‌های فعالیت زنده را در دستگاه‌های iOS ارسال، به‌روزرسانی و پایان دهید. توجه داشته باشید که برای استفاده از فعالیت زنده به iOS 16.1 و برای شروع از راه دور اعلان فعالیت زنده به iOS 17.2 نیاز دارید.
قبل از شروع
قبل از شروع فعالیت زنده در Firebase Cloud Messaging ، دستورالعمل‌های موجود در راه‌اندازی برنامه مشتری Firebase Cloud Messaging در پلتفرم‌های Apple را دنبال کنید تا Firebase Cloud Messaging به برنامه مشتری خود ایجاد و اضافه کنید.
یک فعالیت زنده را شروع کنید
برای شروع یک فعالیت زنده از راه دور با استفاده از Firebase Cloud Messaging ، باید یک توکن push-to-start از اپل دریافت کنید. شما همچنین به رمز ثبت FCM برای برنامه هدف نیاز دارید.
برای ایجاد باری که یک فعالیت زنده را شروع می کند ، فیلد apns.payload را از نمونه کد زیر پر کنید تا از راه دور یک فعالیت زنده را با استفاده از FCM شروع کنید.
استراحت
{ "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
روی Run کلیک کنید تا نمونه را در API Explorer امتحان کنید.
یک فعالیت زنده را به روز کنید
برای به‌روزرسانی یک فعالیت زنده از راه دور با استفاده از Firebase Cloud Messaging ، باید از اپل یک Push Token دریافت کنید. شما همچنین به رمز ثبت FCM برای برنامه هدف نیاز دارید.
برای ایجاد باری که یک فعالیت زنده را به روز می کند ، فیلد apns.payload را از نمونه کد زیر پر کنید تا یک فعالیت زنده با استفاده از FCM از راه دور به روز شود.
استراحت
{ "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
روی Run کلیک کنید تا نمونه را در API Explorer امتحان کنید.
پایان دادن به یک فعالیت زنده
برای پایان دادن به یک فعالیت زنده با استفاده از Firebase Cloud Messaging ، باید از اپل یک Push Token دریافت کنید. شما همچنین به رمز ثبت FCM برای برنامه هدف نیاز دارید.
برای ایجاد باری که به یک فعالیت زنده پایان می دهد ، فیلد apns.payload را از نمونه کد زیر پر کنید تا از راه دور یک فعالیت زنده را با استفاده از FCM پایان دهید.
استراحت
{ "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
روی Run کلیک کنید تا نمونه را در API Explorer امتحان کنید.