INTEGRITY Документация

← Cloudflare Realtime / realtime / realtimekit / recording-guide

Начать запись

В этой статье объясняется, как использовать RealtimeKit для реализации составной записи.

Прежде чем приступить к этому руководству, рекомендуем ознакомиться с Начало работы с RealtimeKit чтобы познакомиться с RealtimeKit.

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

Есть три способа начать запись встречи RealtimeKit:

RealtimeKit хранит записи в течение 7 дней, после чего срок их действия истекает и они становятся недоступны. Важно либо скачать копию записи, либо настроить хранилище до истечения срока действия ссылки.

С помощью record_on_start параметр

Когда создание встречи, вы можете указать record_on_start параметр, чтобы запись запускалась сразу после того, как участник присоединяется к встрече.

Запрос

Укажите record_on_start параметр. Если этот флаг равен true, запись запустится сразу после начала встречи в RealtimeKit, то есть когда первый участник присоединится к встрече.

curl --location 'https://api.cloudflare.com/client/v4/accounts/<account_id>/realtime/kit/<app_id>/meetings' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <api_token>' \
  --data '{
  "title": "Lorem Ipsum",
  "record_on_start": true
}'

Ответ

{
	"success": true,
	"data": {
		"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
		"record_on_start": true,
		"created_at": "2025-08-24T14:15:22Z",
		"updated_at": "2025-08-24T14:15:22Z"
	}
}

Использование Start Recording API

Запись также можно начать с помощью Start Recording API.

Укажите meeting ID встречи, которую вы хотите записать.

Используйте List meetings API для приложения или API для создания встречи чтобы получить идентификатор встречи. API возвращает параметр с именем id, то есть идентификатор вашей встречи.

Запрос

Вызов Start Recording API
curl --location 'https://api.cloudflare.com/client/v4/accounts/<account_id>/realtime/kit/<app_id>/recordings' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <api_token>' \
  --data '{
  "meeting_id": "97440c6a-140b-40a9-9499-b23fd7a3868a"
}'

Ответ

{
	"success": true,
	"data": {
		"id": "97440c6a-140b-40a9-9499-b23fd7a3868a",
		"download_url": "http://example.com",
		"download_url_expiry": "2025-08-24T14:15:22Z",
		"download_audio_url": "http://example1.com",
		"file_size": 0,
		"session_id": "1ffd059c-17ea-40a8-8aef-70fd0307db82",
		"output_file_name": "string",
		"status": "INVOKED",
		"invoked_time": "2025-08-24T14:15:22Z",
		"started_time": "2025-08-24T14:15:22Z",
		"stopped_time": "2025-08-24T14:15:22Z",
		"storage_config": {
			"type": "cloudflare",
			"secret_key": "string",
			"bucket": "string",
			"path": "string"
		}
	}
}