Přepsání parametrů streamu

Přepsání parametrů streamu je volitelné. Je k dispozici pro případ, že byste v přehrávači nebo aplikaci při odesílání žádosti o playlist HLS nebo DASH chtěli přepsat výchozí hodnotu parametru vytvoření streamu nebo výběr či výchozí pořadí variant. Tyto parametry můžete z přehrávače nebo aplikace předávat v implementacích IMA SDK, Server-Side Beaconing (SSB) a DAI API.

Můžete také přepsat i další výchozí parametry značek reklam.

Přepsání výběru a pořadí variant

Výchozí pořadí playlistů určuje majitel obsahu. Pokud parametry pořadí nejsou zadány, odešlou se playlisty v původním pořadí, ve kterém je poskytl majitel obsahu.

Při vytváření streamu můžete výběr variant a zadané parametry pořadí přepsat. Můžete tak určit, které varianty a v jakém pořadí mají být v odpovědi na žádost o hlavní playlist zahrnuty. Může to být užitečné, pokud chcete, aby určitá varianta měla přednost před jinou v závislosti na uživateli, který se na obsah dívá.

Výběr variant a jejich pořadí zůstanou po celou dobu existence streamu stejné. Parametry jsou přijímány buď jako součást struktury adTagParameters (při použití parametrů IMA SDK, DAI API) nebo jako další parametry požadavku HTTP GET při použití SSB.

Parametr	Protokol streamování	Popis	Příklady
dai-aor	HLS, DASH	Rozsah rychlosti připojení pro varianty zvuku, které mají být poskytnuty. Pokud chcete vybrat všechny vyšší rychlosti připojení, stačí zadat údaj startBandwidth. Pokud chcete vybrat všechny nižší rychlosti připojení, zadejte pouze hodnotu :endBandwidth (s dvojtečkou na začátku).	dai-aor=60000
dai-dlid	HLS, DASH	Při vytváření konfigurace sítě CDN pro videoobsah na vyžádání definujte výchozí konfiguraci CDN a další nastavení zobrazování z CDN. Můžete tak nastavit více než jednu síť CDN a na začátku relace pomocí páru klíč–hodnota dynamicky zvolit, ze které chcete obsah zobrazovat. Jakmile konfigurace CDN nastavíte a uložíte, přidělí služba Ad Manager každé z nich název. Tento název byste měli předat do žádosti o vytvoření streamu jako hodnotu parametru dai-dlid. Pokud do žádosti žádný název nepředáte, použije služba Ad Manager výchozí síť CDN.	dai-dlid=AaBbC1aaBa0obA1BABaaBA (AaBbC1aaBa0obA1BABaaBA je název, který se zobrazuje ve službě Ad Manager.)
dai-excl	HLS, DASH	Prvky, které z playlistu mají být vyloučeny. Podporuje hodnoty subtitles, codec, audio-lang, subtitle-lang, iframe a resolution. Pomocí jedné hodnoty nebo seznamu několika čárkami oddělených hodnot můžete vyloučit rozlišení, zvukové kodeky, kodeky videa a jazyky zvuku nebo titulků. Předpona codec je podporována také s příponou „*“, která vylučuje všechny verze s kodeky se zadanou předponou.	dai-excl=subtitles dai-excl=iframe Jeden kodek dai-excl=codec:ec-3 Více kodeků dai-excl=codec:ec-3,codec:ac-3 Předpona kodeků dai-excl=codec:avc1* Zvuk v jednom jazyce dai-excl=audio-lang:en Titulky v jednom jazyce dai-excl=subtitle-lang:en Několik výběrů dai-excl=audio-lang:en, audio-lang:es, subtitle-lang:en, subtitle-lang:es Rozlišení dai-excl=resolution:480x272
dai-os	HLS	Rychlost připojení varianty videa, kterou chcete umístit na začátek hlavního playlistu. Vybere se varianta, jejíž hodnota je nejblíže hodnotě startBandwidth. Pokud jsou od ní dvě hodnoty stejně vzdálené, vybere se nejnižší hodnota. Pokud je zadán tento parametr, ale není zadán parametr dai-aor, jsou vyloučeny všechny varianty obsahující pouze zvuk.	dai-os=1700000
dai-ot	HLS	Informace o typu pořadí, které popisují typ hodnot zadaných pomocí parametru dai-ov. Může se jednat buď o pořadí založené na rychlosti připojení (hodnota bw – nejbližší shoda), NEBO na rychlosti připojení a rozlišení (přesná shoda). Musí být zadána alespoň jedna z možností (rychlost připojení nebo rozlišení). Výchozí hodnota je bw. Pokud je zadán parametr dai-ot, ale není zadán parametr dai-ov, vrátí seznam všechny varianty v původním pořadí.	dai-ot=bw dai-ot=bw_res
dai-ov	HLS	Čárkami oddělené hodnoty udávající pořadí, ve kterém mají být poskytovány playlisty médií. Tento parametr je nutné použít společně s parametrem dai-ot a každá hodnota musí odpovídat typu, který je dán parametrem dai-ot. Pomocí speciální hodnoty „audio“ lze uvést variantu zvuku. Pokud je přítomno několik variant se stejnou hodnotou pořadí (například dvě varianty se stejnou rychlostí připojení, ale jiným rozlišením), zůstane v rámci nich zachováno původní pořadí.	dai-ot=bw&dai-ov=2025837,1406061 dai-ot=bw_res&dai-ov=1400000:640x360,audio
dai-sr	HLS, DASH	Rozsah rychlostí připojení pro poskytované varianty videa. Pokud chcete vybrat všechny vyšší rychlosti připojení, stačí zadat údaj startBandwidth. Pokud chcete vybrat všechny nižší rychlosti připojení, zadejte pouze hodnotu :endBandwidth (s dvojtečkou na začátku). Vynucení rychlosti připojení je určeno pouze pro videoobsah.	dai-sr=1300000:2500000

Další parametry přepsání

Parametr	Protokol streamování	Popis	Příklady
dai-ah	HLS, DASH	Určuje, zda má mít živý přenos reklamní prázdniny, nebo ne. Trvání reklamních prázdnin musí být specifikováno v konfiguraci živého přenosu.	Povolení reklamních prázdnin: dai-ah=1
dai-apto  (verze beta)	HLS, DASH	Časový limit streamu pro rozhodnutí o reklamním podu pro kreativy v obsahu VOD a živých přenosech (v milisekundách). Tato hodnota se používá buď při rozhodování během přestávky, nebo při rozhodování o minulé přestávce, k němuž dochází při vytváření streamu (nikoli při všech budoucích rozhodováních o reklamách po vytvoření streamu). U minulých reklamních přestávek je však k dispozici pouze při použití playlistů typu události (EVENT) nebo parametru dai-dpb. Tento parametr lze nastavit na libovolnou hodnotu v rozsahu od 0 do 10 000. Nastavení velmi nízké nebo vysoké hodnoty by mohlo mít dopad na vyplňování reklamami nebo na uživatelský dojem.	dai-apto=4000
dai-dpb	HLS, DASH	Udává, zda má být u lineárních streamů bez SSB povoleno rozhodování o minulých přestávkách (u streamů SSB je tento parametr ignorován). Pokud je povoleno, rozhoduje se společně s rozhodováním během přestávek i o minulých přestávkách. Tato funkce může mít dopad na počáteční latenci, kterou lze ovládat pomocí parametru dai-apto. Pokud uživatel obsah nepřetočí zpět, zůstanou minulé přestávky nezhlédnuty, což může vést k vyšším počtům zprostředkování kódu.	Zapnutí rozhodování o minulých přestávkách: dai-dpb=true Vypnutí rozhodování o minulých přestávkách pro playlisty HLS typu události (EVENT): dai-dpb=false
dai-dvr	HLS, DASH	Délka DVR (v sekundách) živého obsahu a reklam, které může uživatel posunout zpět, aniž by se narušila plynulost přehrávání.  Aktuální výchozí hodnota je 100 sekund nebo hodnota, kterou jste určili při nastavování přímého přenosu. Pro každý živý přenos můžete určit nové maximum: až 100 sekund pro SSB, až 1800 sekund, pokud používáte sadu SDK nebo rozhraní API. Pokud chcete větší délku DVR, obraťte se na správce účtu. Pokyny a používání Skutečná vrácená délka DVR playlistu se může lišit v závislosti na délce podkladových segmentů. Může se také lišit u jednotlivých variant. Maximální hodnota aktuálního okna by neměla být větší než hodnota okna DVR specifikovaná v události. Pokud ano, bude hodnota automaticky omezena. Ve srovnání se streamy sady SDK nebo veřejného rozhraní API jsou okna DVR pro streamy SSB omezena nižší hodnotou. Snažíme se vracet kompatibilní manifest, nicméně velmi malá nebo velmi velká hodnota může při přehrávání způsobit problémy. Přehrávání by mělo být důkladně otestováno s požadovaným trváním okna DVR, aby vše fungovalo správně. Nepoužívejte různá okna pro různá zařízení. Zadat pro jedno zařízení okno o délce 30 sekund a pro jiná zařízení použít délku 31 sekund nebo 35 sekund není z hlediska výkonu optimální. Používejte raději segmenty oken (pro jednu sadu zařízení například 35 sekund, pro jinou 10 minut atd.). Umožňuje to efektivnější alokaci zdrojů a dosažení lepšího výkonu.	dai-dvr=60
dai-emsgv	HLS	Verze zprávy Event Message je parametr pro vytváření streamů, pomocí kterého mohou volající u obsahu ve formátu Common Media Application Format (CMAF) uvést verze „emsg“. Standard HLS vyžaduje verzi „emsg“ 1. Toto nastavení je užitečné pro platformy, které nepodporují standardní verzi 1 a potřebují verzi 0, jako je například Roku.	dai-emsgv=1
dai-pre (verze beta)	HLS, DASH	Určuje, zda se má u živého přenosu s aktivovanou reklamou před videem zobrazovat reklama před videem namísto reklamy uprostřed videa, pokud se překrývají. Ve výchozím nastavení se místo reklamy před videem zobrazí překrývající se reklama uprostřed videa.	dai-pre=1

Příklady přepsání parametrů

Rozbalit vše  Sbalit vše

Výběr dvou variant

Žádost

https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-ot=bw&dai-ov=2025837,1406061
 

Odpověď

#EXTM3U
#EXT-X-VERSION:3
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=2025837,RESOLUTION=960x540,CODECS="mp4a.40.2,avc1.4d401f"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/2025837.m3u8
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=1406061,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/1406061.m3u8
 

Výběr jedné varianty zvuku a jedné varianty videa

Žádost

https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-ot=bw&dai-ov=audio,1406061
 

Odpověď

#EXTM3U
#EXT-X-VERSION:3
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=64000,RESOLUTION=480x270,CODECS="mp4a.40.2"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/audio.m3u8
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=1406061,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/1406061.m3u8
 

Výběr podle rychlosti připojení a rozlišení

Žádost

https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-ot=bw_res&dai-ov=1400000:640x360,audio
 

Odpověď

#EXTM3U
#EXT-X-VERSION:3
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=1406061,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/1406061.m3u8
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=64000,RESOLUTION=480x270,CODECS="mp4a.40.2"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/audio.m3u8
 

Výběr podle rozsahu rychlostí připojení

Žádost

https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-sr=1300000:2500000&dai-aor=60000
 

Odpověď

#EXTM3U
#EXT-X-VERSION:3
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=1406061,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/1406061.m3u8
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=2025837,RESOLUTION=960x540,CODECS="mp4a.40.2,avc1.4d401f"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/2025837.m3u8
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=64000,RESOLUTION=480x270,CODECS="mp4a.40.2"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/audio.m3u8
 

Zadání počáteční rychlosti připojení

Žádost

https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-os=1700000
 

Odpověď

#EXTM3U
#EXT-X-VERSION:3
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=1406061,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/1406061.m3u8
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=2025837,RESOLUTION=960x540,CODECS="mp4a.40.2,avc1.4d401f"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/2025837.m3u8
 

Vyloučení titulků

Původní manifest s titulky

#EXTM3U
#EXT-X-VERSION:3
#EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="subs",LANGUAGE="en",NAME="English",AUTOSELECT=YES,URI="tt-en.m3u8"
#EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="subs",LANGUAGE="de",NAME="Deutsch",AUTOSELECT=YES,URI="tt-de.m3u8"
#EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="stereo",LANGUAGE="en",NAME="English",DEFAULT=YES,AUTOSELECT=YES,URI="audio.m3u8"
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=889549,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f" SUBTITLES="subs"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/889549.m3u8
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=1406061,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f" SUBTITLES="subs"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/2025837.m3u8
 

Žádost

https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-excl=subtitles
 

Odpověď

#EXTM3U
#EXT-X-VERSION:3
#EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="stereo",LANGUAGE="en",NAME="English",DEFAULT=YES,AUTOSELECT=YES,URI="audio.m3u8"
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=889549,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f" SUBTITLES="subs"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/889549.m3u8
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=1406061,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f" SUBTITLES="subs"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/2025837.m3u8
 

Vyloučení kodeků

Původní manifest s ac-3, eac-3

#EXTM3U
#EXT-X-STREAM-INF:BANDWIDTH=6107776,RESOLUTION=1920x1080,CODECS="avc1.640028,ec-3",AUDIO="AUDIO-EAC3"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/6107776.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=2212301,RESOLUTION=960x540,CODECS="avc1.640028,ec-3",AUDIO="AUDIO-EAC3"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/2212301.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=6295776,RESOLUTION=1920x1080,CODECS="ac-3,avc1.640028",AUDIO="AUDIO-AC3"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/6295776.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=2400301,RESOLUTION=960x540,CODECS="ac-3,avc1.640028",AUDIO="AUDIO-AC3"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/2400301.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=6045381,RESOLUTION=1920x1080,CODECS="avc1.640028,mp4a.40.2",AUDIO="AUDIO-AAC"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/6045381.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=2149906,RESOLUTION=960x540,CODECS="avc1.640028,mp4a.40.2",AUDIO="AUDIO-AAC"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/2149906.m3u8
#EXT-X-MEDIA:TYPE=AUDIO,URI="audio-eac3.m3u8",GROUP-ID="AUDIO-EAC3",LANGUAGE="en",NAME="ENGLISH",AUTOSELECT=YES
#EXT-X-MEDIA:TYPE=AUDIO,URI="audio-ac3.m3u8",GROUP-ID="AUDIO-AC3",LANGUAGE="en",NAME="ENGLISH",AUTOSELECT=YES
#EXT-X-MEDIA:TYPE=AUDIO,URI="audio-aac.m3u8",GROUP-ID="AUDIO-AAC",LANGUAGE="en",NAME="ENGLISH",AUTOSELECT=YES
 

Vyloučení jednoho kodeku

Žádost

http://truman.com/ssai/event/<event_code>/master.m3u8?dai-excl=codec:ec-3
 

Odpověď

#EXTM3U
#EXT-X-STREAM-INF:BANDWIDTH=6295776,RESOLUTION=1920x1080,CODECS="ac-3,avc1.640028",AUDIO="AUDIO-AC3"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/6295776.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=2400301,RESOLUTION=960x540,CODECS="ac-3,avc1.640028",AUDIO="AUDIO-AC3"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/2400301.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=6045381,RESOLUTION=1920x1080,CODECS="avc1.640028,mp4a.40.2",AUDIO="AUDIO-AAC"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/6045381.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=2149906,RESOLUTION=960x540,CODECS="avc1.640028,mp4a.40.2",AUDIO="AUDIO-AAC"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/2149906.m3u8
#EXT-X-MEDIA:TYPE=AUDIO,URI="audio-ac3.m3u8",GROUP-ID="AUDIO-AC3",LANGUAGE="en",NAME="ENGLISH",AUTOSELECT=YES
#EXT-X-MEDIA:TYPE=AUDIO,URI="audio-aac.m3u8",GROUP-ID="AUDIO-AAC",LANGUAGE="en",NAME="ENGLISH",AUTOSELECT=YES
 

Vyloučení několika kodeků

Žádost

http://truman.com/ssai/event/<event_code>/master.m3u8?dai-excl=codec:ec-3,codec:ac-3
 

Odpověď

#EXTM3U
#EXT-X-STREAM-INF:BANDWIDTH=6045381,RESOLUTION=1920x1080,CODECS="avc1.640028,mp4a.40.2",AUDIO="AUDIO-AAC"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/6045381.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=2149906,RESOLUTION=960x540,CODECS="avc1.640028,mp4a.40.2",AUDIO="AUDIO-AAC"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/2149906.m3u8
#EXT-X-MEDIA:TYPE=AUDIO,URI="audio-aac.m3u8",GROUP-ID="AUDIO-AAC",LANGUAGE="en",NAME="ENGLISH",AUTOSELECT=YES
 

Ohledně záležitostí souvisejících s odstraňováním problémů s DAI nebo s výpadky DAI kontaktujte podporu pro majitele obsahu.