Начало работы с 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 .

ОТДЫХ

{
"message": {
  "token": "FCM_TOKEN",
  "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"
        }
      }
    }
  }
}
}

cURL

curl -X POST -H "Authorization: Bearer OAUTH2_ACCESS_TOKEN" -H "Content-Type: application/json" -d '{
"message": {
"token": "FCM_TOKEN",
"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"
      }
    }
  }
}
}
}' https://fcm.googleapis.com/v1/projects/YOUR_PROJECT_ID/messages:send

Бегать

Нажмите «Запустить» , чтобы опробовать пример в API Explorer .

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

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

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

ОТДЫХ

{
"message": {
  "token": "FCM_TOKEN",
  "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"
        }
      }
    }
  }
}
}

cURL

curl -X POST -H "Authorization: Bearer OAUTH2_ACCESS_TOKEN" -H "Content-Type: application/json" -d '{
"message": {
"token": "FCM_TOKEN",
"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"
      }
    }
  }
}
}
}' https://fcm.googleapis.com/v1/projects/YOUR_PROJECT_ID/messages:send

Бегать

Нажмите «Запустить» , чтобы опробовать пример в API Explorer .

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

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

Чтобы создать полезную нагрузку, завершающую активную активность , заполните поле apns.payload из следующего примера кода, чтобы удаленно завершить активную активность с помощью FCM .

ОТДЫХ

{
"message": {
  "token": "FCM_TOKEN",
  "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"
        }
      }
    }
  }
}
}

cURL

curl -X POST -H "Authorization: Bearer OAUTH2_ACCESS_TOKEN" -H "Content-Type: application/json" -d '{
"message": {
"token": "FCM_TOKEN",
"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"
      }
    }
  }
}
}
}' https://fcm.googleapis.com/v1/projects/YOUR_PROJECT_ID/messages:send

Бегать

Нажмите «Запустить» , чтобы опробовать пример в API Explorer .