Начало работы с Live Activity

С помощью API Firebase Cloud Messaging HTTP v1 вы можете удалённо отправлять, обновлять и завершать уведомления о прямых трансляциях на устройствах iOS. Обратите внимание, что для использования прямых трансляций требуется iOS 16.1, а для удалённого запуска уведомлений о прямых трансляциях — iOS 17.2.

Прежде чем начать

Прежде чем приступить к работе с живой активностью в Firebase Cloud Messaging , следуйте инструкциям в разделе Настройка клиентского приложения Firebase Cloud Messaging на платформах Apple, чтобы создать и добавить Firebase Cloud Messaging в свое клиентское приложение.

Начать прямую трансляцию

Для удалённого запуска активного мероприятия с помощью Firebase Cloud Messaging вам необходимо получить токен push-to-start от Apple. Вам также потребуется токен регистрации FCM для целевого приложения.

Чтобы создать полезную нагрузку, запускающую активную активность , заполните поле apns.payload из следующего примера кода для удалённого запуска активной активности с помощью FCM . Для создания и тестирования полезной нагрузки можно использовать API Explorer .

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

Обновить прямую трансляцию

Для удалённого обновления активности в режиме реального времени с помощью Firebase Cloud Messaging необходимо получить push-токен от Apple. Вам также потребуется регистрационный токен FCM для целевого приложения.

Чтобы создать полезную нагрузку, обновляющую активную активность , заполните поле apns.payload из следующего примера кода для удалённого обновления активной активности с помощью FCM . Для создания и тестирования полезной нагрузки можно использовать API Explorer .

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

Завершить прямую трансляцию

Чтобы завершить активное действие с помощью Firebase Cloud Messaging , вам необходимо получить push-токен от Apple. Вам также потребуется регистрационный токен FCM для целевого приложения.

Чтобы создать полезную нагрузку, завершающую активную активность , заполните поле apns.payload из следующего примера кода для удалённого завершения активной активности с помощью FCM . Для создания и тестирования полезной нагрузки можно использовать API Explorer .

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