Mit der Firebase Cloud Messaging HTTP v1 API können Sie Benachrichtigungen zu Liveaktivitäten auf iOS-Geräten per Fernzugriff senden, aktualisieren und beenden. Sie benötigen iOS 16.1, um Live-Aktivitäten zu verwenden, und iOS 17.2, um eine Benachrichtigung zu Live-Aktivitäten per Fernzugriff zu starten.
Hinweis
Bevor Sie mit Live-Aktivitäten auf Firebase Cloud Messaging beginnen, folgen Sie der Anleitung unter Firebase Cloud Messaging-Client-App auf Apple-Plattformen einrichten, um Firebase Cloud Messaging zu erstellen und Ihrer Client-App hinzuzufügen.
Live-Aktivität starten
Wenn Sie eine Live-Aktivität per Fernzugriff mit Firebase Cloud Messaging starten möchten, müssen Sie von Apple ein Push-to-Start-Token abrufen. Außerdem benötigst du das FCM-Registrierungstoken für die Ziel-App.
Wenn Sie einen Nutzlast erstellen möchten, mit dem eine Live-Aktivität gestartet wird, füllen Sie das Feld apns.payload
im folgenden Codebeispiel aus, um eine Live-Aktivität per Fernzugriff mit FCM zu starten. Mit dem APIs Explorer können Sie Ihre Nutzlast erstellen und testen.
"message":{ "token": "<fcm_token:test>", "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" } } } } }
Liveaktivität aktualisieren
Wenn du eine Liveaktivität per Fernzugriff mit Firebase Cloud Messaging aktualisieren möchtest, musst du ein Push-Token von Apple abrufen. Außerdem benötigen Sie das FCM-Registrierungstoken für die Ziel-App.
Wenn du einen Nutzlast erstellen möchtest, mit dem eine Live-Aktivität aktualisiert wird, fülle das Feld apns.payload
im folgenden Codebeispiel aus, um eine Live-Aktivität per Fernzugriff mit FCM zu aktualisieren. Sie können die Nutzlast mit dem API Explorer erstellen und testen.
"message":{ "token": "<fcm_token:test>", "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" } } } } } }
Liveaktivität beenden
Wenn Sie eine Live-Aktivität mit Firebase Cloud Messaging beenden möchten, müssen Sie ein Push-Token von Apple anfordern. Außerdem benötigst du das FCM-Registrierungstoken für die Ziel-App.
Zum Erstellen einer Nutzlast, die eine Live-Aktivität beendet, füllen Sie das Feld apns.payload
aus dem folgenden Codebeispiel aus, um eine Live-Aktivität mit FCM remote zu beenden. Mit dem APIs Explorer können Sie Ihre Nutzlast erstellen und testen.
"message":{ "token": "<fcm_token:test>", "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" } } } } } }