INTEGRITY Dokumentace

← Cloudflare Stream / stream / stream-live

Spuštění živého vysílání

Po přihlášení k odběru Stream můžete vytvářet Live Inputs v Dash nebo přes API. Do nového Live Inputu vysílejte pomocí RTMPS nebo SRT. SRT podporuje novější video kodeky a usnadňuje používání funkcí přístupnosti, jako jsou titulky a více zvukových stop.

Vysíláte živě poprvé? Budete potřebovat software pro odesílání videa do Cloudflare. Přečtěte si, jak spustit živé vysílání na Stream pomocí OBS Studio.

Použijte dashboard

Krok 1: V Cloudflare dashboardu přejděte na Živé vstupy stránku a vytvořte live input.

Přejděte na Živé vstupy ↗ Pole pro vytvoření živého vstupu v dashboardu

Krok 2: Zkopírujte adresu URL RTMPS a klíč a použijte je ve své aplikaci pro živé vysílání. Doporučujeme použít Open Broadcaster Software (OBS) ↗ pro začátek.

Příklad pole URL adresy RTMPS

Krok 3: Spusťte živé vysílání a zobrazte si jeho náhled v Stream Dashboard

V Stream Dashboardu se během několika sekund od zahájení vysílání zobrazí náhled toho, co uvidí vaši diváci. Chcete-li do svého webu nebo aplikace přidat přehrávání živého videa, přečtěte si Přehrávání videí.

Použijte API

Chcete-li spustit živé vysílání programově, proveďte POST požadavek na /live_inputs koncový bod:

Požadavek
curl -X POST \
--header "Authorization: Bearer <API_TOKEN>" \
--data '{"meta": {"name":"test stream"},"recording": { "mode": "automatic" }}' \
https://api.cloudflare.com/client/v4/accounts/{account_id}/stream/live_inputs
Odpověď
{
	"uid": "f256e6ea9341d51eea64c9454659e576",
	"rtmps": {
		"url": "rtmps://live.cloudflare.com:443/live/",
		"streamKey": "MTQ0MTcjM3MjI1NDE3ODIyNTI1MjYyMjE4NTI2ODI1NDcxMzUyMzcf256e6ea9351d51eea64c9454659e576"
	},
	"created": "2021-09-23T05:05:53.451415Z",
	"modified": "2021-09-23T05:05:53.451415Z",
	"meta": {
		"name": "test stream"
	},
	"status": null,
	"recording": {
		"mode": "automatic",
		"requireSignedURLs": false,
		"allowedOrigins": null,
		"hideLiveViewerCount": false
	},
	"enabled": true,
	"deleteRecordingAfterDays": null,
	"preferLowLatency": false
}

Volitelné parametry API

Referenční dokumentace API pro /live_inputs

Následující čtyři vlastnosti jsou vnořené pod recording objekt.

Správa živých vstupů

Aktualizace živého vstupu

Aktualizujte živý vstup odesláním PUT požadavek:

Požadavek
curl --request PUT \
https://api.cloudflare.com/client/v4/accounts/{account_id}/stream/live_inputs/{input_id} \
--header "Authorization: Bearer <API_TOKEN>" \
--data '{"meta": {"name":"test stream 1"},"recording": { "mode": "automatic", "timeoutSeconds": 10 }}'

Povolení nebo zakázání živého vstupu

Živé vstupy jsou ve výchozím stavu povolené. Je-li živý vstup zakázán, odmítá příchozí připojení RTMPS a SRT. Tímto způsobem můžete živý vstup dočasně pozastavit bez jeho smazání, ukončit aktivní vysílání a zabránit zahájení nového vysílání na konkrétním vstupu.

Chcete-li deaktivovat živý vstup, nastavte enabled na false:

Požadavek
curl --request PUT \
https://api.cloudflare.com/client/v4/accounts/{account_id}/stream/live_inputs/{input_id} \
--header "Authorization: Bearer <API_TOKEN>" \
--data '{"enabled": false}'

Chcete-li živý vstup znovu povolit, nastavte enabled na true:

Požadavek
curl --request PUT \
https://api.cloudflare.com/client/v4/accounts/{account_id}/stream/live_inputs/{input_id} \
--header "Authorization: Bearer <API_TOKEN>" \
--data '{"enabled": true}'

Obměna vysílacích klíčů

Vysílací přihlašovací údaje živého vstupu obměňte, pokud mohly být sdíleny s nesprávným publikem, odhaleny v klientském kódu nebo při sdílení obrazovky, nebo pokud je potřeba je obnovit v rámci vašeho bezpečnostního procesu. Obměna klíčů nemění ID živého vstupu ani jeho ostatní nastavení.

Při rotaci klíčů se staré přihlašovací údaje zneplatní, vysílání používající neplatné údaje se odpojí a v odpovědi API se vrátí obnovené přihlašovací údaje.

Požadavek
curl --request POST \
https://api.cloudflare.com/client/v4/accounts/{account_id}/stream/live_inputs/{input_id}/rotate_keys \
--header "Authorization: Bearer <API_TOKEN>"

Odpovědi pro živý vstup obsahují keysRotatedAt, které udává, kdy byly klíče live vstupu naposledy obměněny. Toto pole je vynecháno u live vstupů, jejichž klíče ještě nikdy nebyly obměněny.

Odstranění živého vstupu

Živý vstup odstraníte odesláním DELETE požadavek:

Požadavek
curl --request DELETE \
https://api.cloudflare.com/client/v4/accounts/{account_id}/stream/live_inputs/{input_id} \
--header "Authorization: Bearer <API_TOKEN>"

Doporučení, požadavky a omezení

Pokud se potýkáte s ukládáním do vyrovnávací paměti, zamrzáním, latencí nebo podobnými problémy, navštivte řešení problémů s živým vysíláním.

Doporučení

Doporučení pro vysílání Low-Latency HLS Beta

Požadavky

Omezení