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