Pierwsze kroki z Live Activity

Interfejs Firebase Cloud Messaging HTTP v1 API pozwala 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.

Rozpoczęcie transmisji na żywo

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

Aby utworzyć dane, które uruchamiają aktywność na żywo, wypełnij pole apns.payload z tego przykładowego kodu, aby zdalnie uruchomić aktywność na żywo za pomocą FCM. Do tworzenia i testowania danych 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 aktywności na żywo

Aby zdalnie aktualizować aktywność na żywo za pomocą Firebase Cloud Messaging, musisz uzyskać token push od Apple. Potrzebny będzie też token rejestracji FCM aplikacji docelowej.

Aby utworzyć ładunek aktualizujący aktywną aktywność, wypełnij pole apns.payload z poniższego przykładowego kodu, aby zdalnie zaktualizować aktywną aktywność za pomocą parametru FCM. Do tworzenia i testowania danych 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, 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 danych 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"
          }
        }
      }
    }
  }
}