INTEGRITY Dokumentace

← Cloudflare Realtime / realtime / realtimekit / recording-guide

Spustit nahrávání

Toto téma vysvětluje, jak pomocí RealtimeKit implementovat kompozitní nahrávání.

Než začnete s tímto průvodcem, doporučujeme vám přečíst si Začínáme s RealtimeKit a seznámit se tak s RealtimeKit.

Chcete-li se seznámit s REST API RealtimeKit, doporučujeme prozkoumat RealtimeKit REST API.

Nahrávání schůzky RealtimeKit lze spustit třemi způsoby:

RealtimeKit uchovává nahrávky po dobu 7 dní, poté jejich platnost vyprší a nebudou dále přístupné. Je proto důležité buď si stáhnout kopii nahrávky, nebo nastavit úložiště než odkaz vyprší.

Pomocí record_on_start parametr

Když vytvoření schůzky, můžete zadat record_on_start parametr, který spustí nahrávání, jakmile se ke schůzce připojí první účastník.

Požadavek

Zadejte record_on_start parametr. Pokud je tento příznak nastaven na true, nahrávání se spustí ihned, jakmile schůzka na RealtimeKit začne, tedy ve chvíli, kdy se připojí první účastník.

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

Odpověď

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

Použití Start Recording API

Nahrávání můžete také spustit pomocí Start Recording API.

Zadejte meeting ID schůzky, kterou chcete nahrávat.

Použijte List meetings API pro aplikaci nebo API pro vytvoření schůzky a získáte tak ID schůzky. Rozhraní API vrací parametr nazvaný id, což je ID vaší schůzky.

Požadavek

Volání 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"
}'

Odpověď

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