← Cloudflare Realtime / realtime / realtimekit / recording-guide

Загрузка записи в облако

Вы можете передать необязательный объект storage_config в запросе на начало записи для публикации записи напрямую в вашем облачном провайдере. Если path указан, записанное видео будет сохранено там, в противном случае по умолчанию используется корень каталога.

Имя файла записи будет совпадать с указанным в output_file_name.

Конфигурацию хранилища для записей RealtimeKit можно настроить следующими способами:

Вы можете указать сведения о конфигурации хранилища для всех встреч с помощью RealtimeKit Dashboard.

1. В Cloudflare RealtimeKit Dashboard ↗, перейдите на вкладку Recordings.
2. Нажмите Настройка хранилища.
3. Укажите данные вашего облачного провайдера. Мы поддерживаем передачу записей в бакеты Cloudflare R2, AWS S3, Azure, DigitalOcean и Google Cloud Storage (GCS).

Чтобы ознакомиться с REST API RealtimeKit, рекомендуем изучить RealtimeKit REST API.

Это обеспечивает максимально гибкий уровень контроля и позволяет указать storage_config для конкретного запись начата на встрече.

curl --request POST \
  --url https://api.cloudflare.com/client/v4/accounts/<account_id>/realtime/kit/<app_id>/recordings \
  --header 'Authorization: Bearer <api_authorization_token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "meeting_id": "97440c6a-140b-40a9-9499-b23fd7a3868a",
  "storage_config": {
    "type": "cloudflare",
    "access_key": "your-access-key",
    "secret": "your-secret-key",
    "bucket": "your-bucket-name",
    "path": "/",
    "account_id": "your-account-id"
  }
}'

Чтобы ознакомиться с REST API RealtimeKit, рекомендуем изучить RealtimeKit REST API.

В настоящее время поддерживаются следующие облачные провайдеры:

Чтобы передавать записи в Cloudflare R2, задайте следующие поля в storage_config параметр:

• Тип: укажите cloudflare.
• Access Key: Введите ID ключа доступа R2. Дополнительные сведения см. здесь: Создание API-токенов.
• Bucket: введите имя бакета R2.
• (Необязательно) Path: укажите путь к подпапке, в которую следует переносить записи. Если этот параметр не передан, записи будут перенесены в корневую папку бакета.
• Secret: Введите свой секретный ключ доступа R2.
• Account ID: Введите ID своей учётной записи Cloudflare.

Чтобы передавать записи в bucket AWS S3, задайте следующие поля в storage_config параметр:

• Тип: укажите aws.
• Access Key: Введите свой aws_access_key_id.
• Bucket: введите имя бакета AWS S3.
• (Необязательно) Path: укажите путь к подпапке, в которую следует переносить записи. Если этот параметр не передан, записи будут перенесены в корневую папку бакета.
• Secret: Введите свой aws_secret_access_key.
• Region: укажите регион, в котором размещён ваш бакет, например, ap-south-1.

Чтобы передавать записи в Azure Blob Storage, задайте следующие поля в storage_config параметр:

• Тип: укажите azure.
• Access key: Введите строку подключения Azure. Дополнительные сведения о том, как получить ключ доступа, см. здесь: Просмотр ключа доступа к аккаунту ↗.
• Bucket: введите имя контейнера. Контейнер должен находиться в той же учётной записи хранилища, что и connection string.
• (Необязательно) Path: укажите путь к подпапке, в которую следует переносить записи. Если этот параметр не передан, записи будут перенесены в корневую папку контейнера.
• Secret: Задайте пустую строку "".
• Region: укажите пустую строку "".

Чтобы передавать записи в DigitalOcean Spaces, задайте следующие поля в storage_config параметр:

• Тип: укажите digitalocean.
• Access key: Введите ключ доступа DigitalOcean. Дополнительные сведения см. здесь: Создание DigitalOcean Space и API Key ↗.
• Bucket: введите имя бакета Spaces.
• (Необязательно) Path: укажите путь к подпапке, в которую следует переносить записи. Если этот параметр не передан, записи будут перенесены в корневую папку контейнера.
• Secret: Введите свой секрет Spaces.
• Region: укажите регион, в котором размещён ваш бакет Spaces, например, SGP1. Дополнительную информацию см. Region Availability Matrix ↗.

Чтобы передавать записи в GCS, задайте следующие поля в storage_config параметр:

• Тип: укажите gcs.
• Bucket: введите имя бакета Cloud Storage.
• (Необязательно) Path: укажите путь к подпапке, в которую следует переносить записи. Если этот параметр не передан, записи будут перенесены в корневую папку контейнера.
• Secret: Введите учётные данные сервисного аккаунта. Дополнительные сведения см. здесь: учётные данные сервисного аккаунта ↗.
• Region: укажите регион, в котором размещён ваш бакет Cloud Storage, например, US multi-region. Дополнительную информацию см. Расположения бакетов ↗.

Имя файла записи можно изменить с помощью file_name_prefix поле. Формат имени файла записи по умолчанию: roomname_timestamp, но вы можете добавить к имени файла по умолчанию префикс из букв, цифр и символа подчёркивания.

Важно учитывать, что к имени файла по умолчанию можно добавить только префикс, полностью изменить имя файла нельзя. Например, если вы в 9 утра проводите онлайн-урок физики с помощью RealtimeKit, вы можете добавить Physics_9am к имени файла. Physics_9am_roomname_timestamp будет новым именем файла.

Дополнительную информацию см. в начать запись встречи.