Pierwsze kroki z Live Activity

Dzięki interfejsowi Firebase Cloud Messaging HTTP w wersji 1 API możesz zdalnie wysyłać, aktualizować i kończyć powiadomienia o aktywności na żywo na urządzeniach z iOS. Pamiętaj, że do korzystania z aktywności na żywo potrzebny jest system iOS 16.1, a do zdalnego uruchamiania powiadomień o aktywności na żywo – system iOS 17.2.

Zanim zaczniesz

Zanim zaczniesz korzystać z funkcji na żywo w Firebase Cloud Messaging, wykonaj instrukcje w artykule Konfigurowanie aplikacji klienta Komunikacji w chmurze Firebase na platformach Apple, aby utworzyć i dodać Firebase Cloud Messaging do aplikacji klienta.

Rozpocznij transmisję na żywo

Aby rozpocząć aktywność na żywo zdalnie za pomocą Firebase Cloud Messaging, musisz uzyskać token push-to-start od Apple. Potrzebujesz też FCMtokenu rejestracyjnego aplikacji docelowej.

Aby utworzyć dane, które uruchamiają transmisję na żywo, wypełnij pole apns.payload z tego przykładowego kodu, aby zdalnie uruchomić transmisję na żywo za pomocą FCM. Do tworzenia i testowania ładunku możesz użyć eksploratora interfejsu API.

"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"
          }
        }
      }
    }
  }

Aktualizowanie aktywnej aktywności

Aby zdalnie aktualizować aktywność na żywo za pomocą Firebase Cloud Messaging, musisz uzyskać token push od Apple. Potrzebujesz też FCMtokenu rejestracyjnego aplikacji docelowej.

Aby utworzyć dane, które zaktualizują aktywność na żywo, wypełnij pole apns.payload z tego przykładowego kodu, aby zdalnie aktualizować aktywność na żywo za pomocą FCM. Do tworzenia i testowania ładunku możesz użyć eksploratora interfejsu API.

"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"
          }
        }
      }
    }
  }
}

Zamykanie transmisji na żywo

Aby zakończyć aktywność na żywo za pomocą Firebase Cloud Messaging, musisz uzyskać token powiadomień od Apple. Musisz też mieć token rejestracji FCM aplikacji docelowej.

Aby utworzyć dane ładunku, które kończą aktywność na żywo, wypełnij pole apns.payload z tego przykładowego kodu, aby zdalnie zakończyć aktywność na żywo za pomocą FCM. Do tworzenia i testowania ładunku możesz użyć eksploratora interfejsu API.

"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"
          }
        }
      }
    }
  }
}