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 คุณต้อง ขอโทเค็นกดเพื่อเริ่ม จาก 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 คุณต้อง ขอโทเค็นพุช จาก 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
หากต้องการสิ้นสุดกิจกรรมสดโดยใช้ Firebase Cloud Messaging คุณต้องขอโทเค็นพุช จาก 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