Firebase Cloud Messaging HTTP v1 API ile iOS cihazlarda canlı etkinlik bildirimlerini uzaktan gönderebilir, güncelleyebilir ve sonlandırabilirsiniz. Live Etkinliği'ni kullanmak için iOS 16.1, Live Etkinliği bildirimini uzaktan başlatmak için ise iOS 17.2 sürümünün yüklü olması gerektiğini unutmayın.
Başlamadan önce
Firebase Cloud Messaging üzerinde canlı etkinliği kullanmaya başlamadan önce Apple platformlarında Firebase Cloud Messaging istemci uygulaması oluşturma başlıklı makaledeki talimatları uygulayarak Firebase Cloud Messaging oluşturun ve istemci uygulamanıza ekleyin.
Canlı etkinlik başlatma
Firebase Cloud Messaging kullanarak canlı etkinliği uzaktan başlatmak için Apple'dan başlatmak için basma jetonu almanız gerekir. Ayrıca hedef uygulama için FCM kayıt jetonuna da ihtiyacınız vardır.
Canlı etkinlik başlatan bir yük oluşturmak için aşağıdaki kod örneğindeki apns.payload alanını doldurarak FCM ile uzaktan canlı etkinlik başlatın.
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 Gezgini'nde örneği denemek için Çalıştır'ı tıklayın.
Canlı etkinliği güncelleme
Firebase Cloud Messaging kullanarak etkin bir aktiviteyi uzaktan güncellemek için Apple'dan push jetonu almanız gerekir. Ayrıca hedef uygulama için FCM kayıt jetonuna da ihtiyacınız olacaktır.
Canlı Etkinlik'i güncelleyen bir yük oluşturmak için aşağıdaki kod örneğindeki apns.payload alanını doldurarak FCM kullanarak bir Canlı Etkinlik'i uzaktan güncelleyin.
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 Gezgini'nde örneği denemek için Çalıştır'ı tıklayın.
Canlı etkinliği sonlandırma
Firebase Cloud Messaging kullanarak canlı etkinliği sonlandırmak için Apple'dan push token almanız gerekir. Ayrıca hedef uygulama için FCM kayıt jetonuna da ihtiyacınız olacaktır.
Canlı etkinliği sonlandıran bir yük oluşturmak için aşağıdaki kod örneğindeki apns.payload alanını doldurarak FCM ile canlı etkinliği uzaktan sonlandırın.
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
Örneği API Gezgini'nde denemek için Çalıştır'ı tıklayın.