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ötigen Sie das FCM-Registrierungstoken für die Ziel-App.
Zum Erstellen einer Nutzlast, die eine Live-Aktivität startet, füllen Sie das Feld apns.payload aus dem folgenden Codebeispiel aus, um eine Live-Aktivität mit FCM remote 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"
}
}
}
}
}
Live-Aktivitäten 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ötigst du 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. 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>,
"event": "update",
"content-state": {
"test1": 100,
"test2": "demo"
},
"alert": {
"title": "test title",
"body": "test body"
}
}
}
}
}
}
Liveaktivität beenden
Wenn Sie eine Liveaktivität mit Firebase Cloud Messaging beenden möchten, müssen Sie ein Push-Token von Apple abrufen. Außerdem benötigen Sie 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"
}
}
}
}
}
}