← Cloudflare Stream / stream / stream-live

Sledování živého vysílání

Když je Živý vstup začne přijímat vysílání, automaticky se vytvoří nové video, pokud vstup má mode vlastnost je nastavena na automatic.

Ke sledování nabízí Stream vestavěný přehrávač, nebo můžete použít vlastní přehrávač s manifesty HLS a DASH.

Ať už používáte Stream Player, nebo vlastní přehrávač s manifestem, můžete odkazovat na Live Input ID nebo konkrétní Video ID. Hlavní rozdíl je v tom, co se stane po skončení vysílání.

Identifikátor Live Input ID použijte v případech, kdy má přehrávač vždy zobrazovat aktivní vysílání, pokud nějaké probíhá, nebo zprávu „Stream has not started“, pokud je vstup neaktivní. Tato možnost je nejvhodnější pro stránky věnované konkrétnímu tvůrci, kanálu nebo pravidelnému pořadu. Live Input ID se vygeneruje automaticky při vytvoření vstupu a už se nezmění.

Identifikátor Video ID použijte v případech, kdy má přehrávač zobrazovat jediné vysílání nebo jeho záznam po jeho skončení. Tato možnost je nejvhodnější pro stránky věnované jednorázové události, konkrétní epizodě nebo datu. Existuje nový ID videa vygenerované pro každé vysílání až to začne.

Při použití režimu DVR, který je popsán níže, je třeba zohlednit několik dalších skutečností.

Adresy URL Stream jsou šablonovité, takže se snadno generují:

Formát URL vestavěného přehrávače Stream Player:

https://customer-<CODE>.cloudflarestream.com/<INPUT_ID|VIDEO_ID>/iframe

Úplný vkládací kód lze vygenerovat v Dash nebo pomocí API.

Formát HLS Manifest URL:

https://customer-<CODE>.cloudflarestream.com/<INPUT_ID|VIDEO_ID>/manifest/video.m3u8

Vkládací kód nebo adresy URL manifestu můžete získat i z Dash nebo přes API.

Chcete-li získat vkládací kód vestavěného přehrávače Stream nebo adresu URL manifestu HLS pro vlastní přehrávač:

1. V dashboardu Cloudflare přejděte na Živé vstupy stránce.

   Přejděte na Živé vstupy ↗

2. Vyberte živý vstup ze seznamu.

3. Najděte Vložení a HLS Manifest URL pod videem.

4. Určete, kterou možnost chcete použít, a poté vyberte Kliknutím zkopírujete pod vaší volbou.

Vkládací kód nebo URL adresa manifestu získané v Dash odkazují na Live Input ID.

Chcete-li přes API získat kód přehrávače nebo adresy URL manifestů, načtěte seznam videí živého vstupu:

curl -X GET \
-H "Authorization: Bearer <API_TOKEN>" \
https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/stream/live_inputs/<LIVE_INPUT_UID>/videos

S jedním Live Input je spojeno více videí, jedno pro každé vysílání. Pokud probíhá aktivní vysílání, první video v odpovědi bude mít live-inprogress stavu. Ostatní videa v odpovědi představují nahrávky, které lze přehrávat na vyžádání.

Každé video v odpovědi, včetně aktivního vysílání, pokud právě probíhá, obsahuje URL adresy HLS a DASH a odkaz na přehrávač Stream. Mezi významné vlastnosti patří:

• preview -- odkaz na přehrávač Stream Player ke sledování
• playback.hls -- HLS Manifest
• playback.dash -- DASH Manifest

V následujícím příkladu má živé video stav live-inprogress a stav pro dříve nahrané video je ready.

{
  "result": [
    {
      "uid": "6b9e68b07dfee8cc2d116e4c51d6a957",
      "thumbnail": "https://customer-f33zs165nr7gyfy4.cloudflarestream.com/6b9e68b07dfee8cc2d116e4c51d6a957/thumbnails/thumbnail.jpg",

      "status": {
        "state": "live-inprogress",
        "errorReasonCode": "",
        "errorReasonText": ""
      },
      "meta": {
        "name": "Stream Live Test 23 Sep 21 05:44 UTC"
      },
      "created": "2021-09-23T05:44:30.453838Z",
      "modified": "2021-09-23T05:44:30.453838Z",
      "size": 0,
      "preview": "https://customer-f33zs165nr7gyfy4.cloudflarestream.com/6b9e68b07dfee8cc2d116e4c51d6a957/watch",
      ...

      "playback": {
        "hls": "https://customer-f33zs165nr7gyfy4.cloudflarestream.com/6b9e68b07dfee8cc2d116e4c51d6a957/manifest/video.m3u8",
        "dash": "https://customer-f33zs165nr7gyfy4.cloudflarestream.com/6b9e68b07dfee8cc2d116e4c51d6a957/manifest/video.mpd"
      },
      ...
    },
    {
      "uid": "6b9e68b07dfee8cc2d116e4c51d6a957",
      "thumbnail": "https://customer-f33zs165nr7gyfy4.cloudflarestream.com/6b9e68b07dfee8cc2d116e4c51d6a957/thumbnails/thumbnail.jpg",
      "thumbnailTimestampPct": 0,
      "readyToStream": true,
      "status": {
        "state": "ready",
        "pctComplete": "100.000000",
        "errorReasonCode": "",
        "errorReasonText": ""
      },
      "meta": {
        "name": "CFTV Staging 22 Sep 21 22:12 UTC"
      },
      "created": "2021-09-22T22:12:53.587306Z",
      "modified": "2021-09-23T00:14:05.591333Z",
      "size": 0,
      "preview": "https://customer-f33zs165nr7gyfy4.cloudflarestream.com/6b9e68b07dfee8cc2d116e4c51d6a957/watch",
      ...
      "playback": {
        "hls": "https://customer-f33zs165nr7gyfy4.cloudflarestream.com/6b9e68b07dfee8cc2d116e4c51d6a957/manifest/video.m3u8",
        "dash": "https://customer-f33zs165nr7gyfy4.cloudflarestream.com/6b9e68b07dfee8cc2d116e4c51d6a957/manifest/video.mpd"
      },
    }
  ],
}

Ty budou odkazovat na Video ID.

Můžete zjistit, zda živý vstup právě vysílá a jaké je jeho aktivní video ID, a to odesláním požadavku na jeho lifecycle endpoint. Přehrávač Stream toto dělá automaticky a zobrazí poznámku, když je vstup neaktivní. Vlastní přehrávače mohou vyžadovat další podporu.

curl -X GET \
-H "Authorization: Bearer <API_TOKEN>" \
https://customer-<CODE>.cloudflarestream.com/<INPUT_ID>/lifecycle

V následujícím příkladu odpověď udává ID platí pro vstup s aktivním videoUID. live hodnota stavu udává, že input aktivně vysílá.

{
	"isInput": true,
	"videoUID": "55b9b5ce48c3968c6b514c458959d6a",
	"live": true
}

{
	"isInput": true,
	"videoUID": null,
	"live": false
}

Při sledování živého vysílání prostřednictvím Live Input ID se requireSignedURLs a allowedOrigins se použijí z nastavení nahrávání live inputu. Toto nastavení je nezávislé na nastavení na úrovni videa.

Po skončení živého vysílání se automaticky vygeneruje záznam, který je dostupný do 60 sekund. Aby přehrávání a zobrazení videa proběhlo úspěšně, mějte na paměti následující:

• Pokud živý přenos skončí ve chvíli, kdy ho divák sleduje, měl by uživatel přehrávače Stream počkat 60 sekund a poté přehrávač znovu načíst, aby zhlédl záznam přenosu.
• Po skončení živého vysílání můžete stav záznamu zkontrolovat přes API. Když je stav videa ready, můžete k přehrávání nahraného záznamu použít jednu z manifestových URL adres.

Zatímco se generuje záznam živého vysílání, video se může zobrazovat jako not-found nebo not-started.

Pokud pro záznamy živých přenosů nepoužíváte přehrávač Stream, přečtěte si Nahrávání a zpětné přehrávání živých vysílání kde najdete další informace o přehrávání záznamu živého vysílání.