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