Erste Schritte mit Live-Aktivitäten

Mit der Firebase Cloud Messaging HTTP v1 API können Sie Benachrichtigungen zu Live-Aktivitäten auf iOS-Geräten senden, aktualisieren und beenden. Für die Verwendung von Live-Aktivitäten ist iOS 16.1 erforderlich. Für das Remote-Starten einer Benachrichtigung zu einer Live-Aktivität ist iOS 17.2 erforderlich.

Hinweis

Bevor Sie mit Live-Aktivitäten in 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 mit Firebase Cloud Messaging aus der Ferne starten möchten, müssen Sie von Apple ein Push-to-Start-Token anfordern. Außerdem benötigen Sie das FCM-Registrierungstoken für die Ziel-App.

Wenn Sie eine Nutzlast erstellen möchten, mit der eine Live-Aktivität gestartet wird, füllen Sie das Feld apns.payload aus dem folgenden Codebeispiel aus, um eine Live-Aktivität mit FCM remote zu starten. Sie können den API Explorer verwenden, um Ihre Nutzlast zu erstellen und zu 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ät aktualisieren

Wenn Sie eine Live-Aktivität mithilfe von Firebase Cloud Messaging remote aktualisieren möchten, müssen Sie ein Push-Token von Apple abrufen. Außerdem benötigen Sie das FCM-Registrierungstoken für die Ziel-App.

Um eine Nutzlast zu erstellen, mit der eine Live-Aktivität aktualisiert wird, füllen Sie das Feld apns.payload aus dem folgenden Codebeispiel aus, um eine Live-Aktivität mit FCM remote zu aktualisieren. Sie können den API Explorer verwenden, um Ihre Nutzlast zu erstellen und zu 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"
          }
        }
      }
    }
  }
}

Live-Aktivität beenden

Wenn Sie eine Live-Aktivitä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.

Wenn Sie eine Nutzlast erstellen möchten, mit der eine Live-Aktivität beendet wird, füllen Sie das Feld apns.payload aus dem folgenden Codebeispiel aus, um eine Live-Aktivität mit FCM remote zu beenden. Sie können den API Explorer verwenden, um Ihre Nutzlast zu erstellen und zu 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"
          }
        }
      }
    }
  }
}