← Cloudflare Stream / stream / uploading-videos

Player API

Atributy se přidávají v <stream> značku bez uvozovek, jak je vidět níže:

<stream attribute-added-here src="5d5bc37ffcf54c9b82e996823bffbb81"></stream>

Více atributů lze použít společně, přidaných jeden za druhým takto:

<stream attribute-1 attribute-2 attribute-3 src="5d5bc37ffcf54c9b82e996823bffbb81"></stream>

• autoplay boolean

  • Řekne prohlížeči, aby video začal okamžitě stahovat a přehrál ho, jakmile to bude možné. Mobilní prohlížeče tento atribut obvykle nepodporují, uživatel musí přehrávání videa spustit klepnutím na obrazovku. Než tento atribut použijete, zvažte uživatele mobilních zařízení nebo uživatele s omezeným datovým limitem, protože ne všichni mají neomezený přístup k internetu.

• controls boolean

  • Zobrazuje výchozí ovládací prvky videa, jako jsou tlačítka pro přehrání/pozastavení a ovládání hlasitosti. Můžete si také vytvořit vlastní tlačítka a ovládací prvky fungující s přehrávačem. Podívejte se na příklad.

• height celé číslo

  • Výška zobrazovací plochy videa v CSS pixelech.

• loop boolean

  • Booleovský atribut. Pokud je uveden v tagu HTML, přehrávač po dosažení konce videa automaticky přeskočí zpět na začátek.

• muted boolean

  • Booleovský atribut, který určuje výchozí nastavení zvuku obsaženého ve videu. Je-li nastaven, zvuk bude na začátku ztlumený.

• preload string | null

  • Tento výčtový atribut má prohlížeči napovědět, co podle autora povede k nejlepšímu uživatelskému zážitku. Tento atribut můžete uvést jako booleovský bez hodnoty, nebo můžete zadat hodnotu preload="auto" k přednačtení začátku videa. Pokud atribut vynecháte nebo použijete preload="metadata" na vyžádání načte pouze metadata potřebná ke spuštění přehrávání videa.

• poster string

  • URL adresa obrázku, který se zobrazí před spuštěním videa nebo během jeho stahování. Pokud tento atribut není zadán, zobrazí se náhledový obrázek videa.

• src string

  • Zde by mělo být uvedeno ID videa, které jste nahráli do Cloudflare Stream.

• width celé číslo

  • Šířka zobrazovací plochy videa v pixelech CSS.

• play() Promise

  • Spustí přehrávání videa.

• pause() null

  • Pozastavte přehrávání videa.

• autoplay

  • Nastavuje nebo vrací, zda byl nastaven atribut autoplay, který umožňuje spustit přehrávání videa ihned po načtení.

• controls

  • Nastavuje nebo vrací, zda se mají u videa zobrazovat ovládací prvky (například přehrát/pozastavit)

• currentTime

  • Vrátí aktuální čas přehrávání v sekundách. Nastavením této hodnoty se video přetočí na nový čas.

• duration pouze pro čtení

  • Vrátí délku videa v sekundách.

• ended pouze pro čtení

  • Vrátí, zda video skončilo.

• loop

  • Nastavuje nebo vrací, zda se má video po dosažení konce přehrát znovu od začátku

• muted

  • Nastavuje nebo vrací, zda se má u videa přehrávat zvuk

• paused pouze pro čtení

  • Vrátí, zda je video pozastaveno

• preload

  • Nastavuje nebo vrací, zda se má video přednačíst při načtení prvku.

• volume

  • Nastavuje nebo vrací hlasitost od 0.0 (ticho) do 1.0 (maximální hodnota)

Stream podporuje většinu standardizované události mediálního prvku ↗.

• abort

  • Odešle se při přerušení přehrávání, například když se přehrávané médium restartuje od začátku.

• canplay

  • Odešle se, jakmile je k dispozici dostatek dat pro přehrání média, alespoň pro několik snímků.

• canplaythrough

  • Odešle se, pokud lze celé médium přehrát bez přerušení za předpokladu, že rychlost stahování zůstane alespoň na současné úrovni. Vyvolá se také při přepnutí přehrávání mezi pozastaveným a spuštěným stavem. Poznámka: ruční nastavení hodnoty currentTime nakonec ve Firefoxu vyvolá událost canplaythrough. Jiné prohlížeče tuto událost nemusí vyvolat.

• durationchange

  • Metadata byla načtena nebo se změnila, což signalizuje změnu délky média. K tomu dochází například tehdy, když se médium načte natolik, že je známa jeho délka.

• ended

  • Odešle se po dokončení přehrávání.

• error

  • Odešle se při výskytu chyby (například video ještě nebylo dokódováno, nebo se video nepodařilo načíst kvůli neplatné podepsané URL adrese)

• loadeddata

  • Načtení prvního snímku média bylo dokončeno.

• loadedmetadata

  • Načítání metadat média bylo dokončeno; všechny atributy nyní obsahují tolik užitečných informací, kolik jich mohou obsahovat.

• loadstart

  • Odešle se při zahájení načítání média.

• pause

  • Odešle se při přepnutí stavu přehrávání na pozastaveno (vlastnost paused má hodnotu true).

• play

  • Odešle se, jakmile přehrávání přestane být pozastaveno, ať už v důsledku volání metody play, nebo atributu autoplay.

• playing

  • Odešle se, jakmile má médium dostatek dat pro spuštění přehrávání, tedy po události play, ale i při obnovení po zaseknutí, při restartu opakovaně přehrávaného média a po události seeked, pokud přehrávání probíhalo ještě před posunem.

• progress

  • Odesílá se pravidelně, aby informoval zainteresované strany o průběhu stahování médií. Informace o aktuálním množství staženého média jsou dostupné v atributu buffered daného mediálního prvku.

• ratechange

  • Odešle se při změně rychlosti přehrávání.

• seeked

  • Odešle se po dokončení posunu v přehrávání.

• seeking

  • Odešle se při zahájení posunu v přehrávání.

• stalled

  • Odešle se, když se user agent pokouší načíst data média, ale data neočekávaně nepřicházejí.

• suspend

  • Odešle se, když se načítání média přeruší, ať už proto, že stahování skončilo, nebo bylo z jiného důvodu pozastaveno.

• timeupdate

  • Čas udávaný atributem currentTime elementu se změnil.

• volumechange

  • Odešle se při změně hlasitosti zvuku, tedy jak při nastavení hlasitosti, tak při změně atributu muted.

• waiting

  • Odešle se, když se požadovaná operace (například přehrávání) odloží, protože čeká na dokončení jiné operace (například posunu).

Nestandardní události mají prefix stream- aby se odlišily od standardních událostí.

• stream-adstart

  • Aktivuje se, když ad-url atribut je přítomen a reklama začne přehrávat

• stream-adend

  • Aktivuje se, když ad-url atribut je přítomen a reklama dokončí přehrávání

• stream-adtimeout

  • Aktivuje se, když ad-url atribut je přítomen a načtení reklamy trvalo příliš dlouho.