ด้วย Firebase Cloud Messaging HTTP v1 API คุณสามารถส่ง อัปเดต และสิ้นสุดการแจ้งเตือนกิจกรรม Live จากระยะไกลในอุปกรณ์ iOS ได้ โปรดทราบว่าคุณต้องใช้ iOS 16.1 เพื่อใช้กิจกรรม Live และ iOS 17.2 เพื่อเริ่มการแจ้งเตือนกิจกรรม Live จากระยะไกล
ก่อนเริ่มต้น
ก่อนเริ่มต้นใช้งานกิจกรรม Live ใน Firebase Cloud Messaging ให้ทำตาม วิธีการใน ตั้งค่าแอปไคลเอ็นต์ Firebase Cloud Messaging ในแพลตฟอร์ม Apple เพื่อสร้างและเพิ่ม Firebase Cloud Messaging ลงในแอปไคลเอ็นต์
เริ่มกิจกรรม Live
หากต้องการเริ่มกิจกรรม Live จากระยะไกลโดยใช้ Firebase Cloud Messaging คุณต้อง ขอรับ โทเค็น push-to-start จาก Apple นอกจากนี้ คุณยังต้องมี FCM การลงทะเบียน โทเค็น สำหรับแอปเป้าหมายด้วย
หากต้องการสร้างเพย์โหลดที่จะเริ่มกิจกรรม Live
ให้กรอกข้อมูลในช่อง
apns.payloadจากตัวอย่างโค้ดต่อไปนี้เพื่อเริ่มกิจกรรม Live จากระยะไกลโดยใช้
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
อัปเดตกิจกรรม Live
หากต้องการอัปเดตกิจกรรม Live จากระยะไกลโดยใช้ Firebase Cloud Messaging คุณต้อง ขอรับ โทเค็น push จาก Apple นอกจากนี้ คุณยังต้องมี FCM การลงทะเบียน โทเค็น สำหรับแอปเป้าหมายด้วย
หากต้องการสร้างเพย์โหลดที่จะอัปเดตกิจกรรม Live
ให้กรอกข้อมูลในช่อง
apns.payloadจากตัวอย่างโค้ดต่อไปนี้เพื่ออัปเดตกิจกรรม Live จากระยะไกลโดยใช้
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
สิ้นสุดกิจกรรม Live
หากต้องการสิ้นสุดกิจกรรม Live โดยใช้ Firebase Cloud Messaging คุณต้องขอรับโทเค็น push token จาก Apple นอกจากนี้ คุณยังต้องมี FCM การลงทะเบียน โทเค็น สำหรับแอปเป้าหมายด้วย
หากต้องการสร้างเพย์โหลดที่จะสิ้นสุดกิจกรรม Live
ให้กรอกข้อมูลในช่อง
apns.payloadจากตัวอย่างโค้ดต่อไปนี้เพื่อสิ้นสุดกิจกรรม Live จากระยะไกลโดยใช้
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