Streamparaméterek felülbírálása

A streamparaméterek felülbírálása nem kötelező. Akkor használható, ha azt szeretné, hogy a lejátszó vagy az alkalmazás felülbírálja az egyik streamlétrehozási paraméter alapértelmezett értékét, vagy felülbírálja a változatkiválasztást vagy a változók alapértelmezett sorrendjét a HLS vagy a DASH lejátszási lista kérelmezésekor. Az IMA SDK-val, szerveroldali „beaconing” (SSB) módszerrel, illetve a DAI API-val történő implementáció esetén a lejátszóból vagy az alkalmazásból is átadhatja ezeket a paramétereket.

Egyéb alapértelmezett hirdetésicímke-paramétereket is felülbírálhat.

A változatkiválasztás és -sorrend felülbírálása

A lejátszási lista alapértelmezett sorrendjét a megjelenítő határozza meg. Ha nincs megadva rendezési paraméter, a lejátszási listák visszaküldése a megjelenítő által biztosított eredeti sorrendben történik.

A stream létrehozásakor megadott változatkiválasztási és sorrendparamétereket felül lehet bírálni. Ez lehetővé teszi a változatok azon alcsoportjának megadását, amelynek szerepelnie kell az elsődleges lejátszási listára irányuló kérelemre adott válaszban, valamint segítségével a változatok sorrendje is meghatározható. Ez akkor lehet hasznos, ha valamelyik változatnak elsőbbséget kell élveznie egy másikkal szemben a tartalmat fogyasztó felhasználó alapján.

Az alcsoport és a változatok sorrendje ugyanaz marad a stream élettartama során. A paraméterek elfogadhatók az adTagParameters struktúra részeként az IMA SDK vagy a DAI API paramétereinek használatakor, illetve kiegészítő HTTP GET paraméterekként az SSB használatakor.

Paraméter	Streamprotokoll	Leírás	Példák
dai-aor	HLS, DASH	A visszaküldendő audiováltozatok sávszélesség-tartománya. Az összes magasabb sávszélesség kiválasztásához csak a startBandwidth paramétert határozza meg.Az összes alacsonyabb sávszélesség kiválasztásához csak az :endBandwidth paramétert határozza meg (kettőspont, vagyis „:” előtaggal).	dai-aor=60000
dai-dlid	HLS, DASH	Amikor CDN-konfigurációt hoz létre igény szerinti videóközvetítési tartalmaihoz, adjon meg alapértelmezett CDN-konfigurációt és további CDN-megjelenítési beállításokat. Így egynél több CDN-t is beállíthat, és munkafolyamat indításakor kulcsérték használatával dinamikusan kiválaszthatja, hogy melyiket szeretné használni a megjelenítéshez. A CDN-konfigurációk beállítása és mentése után a Ad Manager elnevezi őket. Ezt a nevet kell átadni az streamlétrehozási kérelemnek a dai-dlid paraméter értékeként. Ha nem ad át nevet a kérelemnek, az Ad Manager az alapértelmezett CDN-t használja.	dai-dlid=AaBbC1aaBa0obA1BABaaBA (Az AaBbC1aaBa0obA1BABaaBA az Ad Managerben megjelenő név.)
dai-excl	HLS, DASH	A lejátszási listáról kizárni kívánt megjelenítések. A következőket támogatja: subtitles, codec, audio-lang, subtitle-lang, iframe, és resolution. Kizárhat felbontásokat, audiokodekeket, videokodekeket, valamint hang- és/vagy feliratnyelveket egyetlen érték vagy több érték vesszővel elválasztott listájának használatával. A codec előtag a „*” utótaggal is támogattt, amely kizárja a megadott előtaggal rendelkező codec használatával végzett összes megjelenítést.	dai-excl=subtitles dai-excl=iframe Egyetlen kodek dai-excl=codec:ec-3 Több kodek dai-excl=codec:ec-3,codec:ac-3 Előtagkodek dai-excl=codec:avc1* Egynyelvű hang dai-excl=audio-lang:en Egynyelvű felirat dai-excl=subtitle-lang:en Több elem kiválasztása dai-excl=audio-lang:en, audio-lang:es, subtitle-lang:en, subtitle-lang:es Felbontás dai-excl=resolution:480x272
dai-os	HLS	A fő lejátszási lista elejére helyezni kívánt videóváltozat sávszélessége. A rendszer a startBandwidth értékéhez legközelebb álló változatot választja ki. Ha két érték egyenlő távolságra van tőle, akkor a legalacsonyabb értéket választja ki. Ha ez a paraméter meg van adva, a dai-aor azonban nincs, a rendszer az összes, csak audiót tartalmazó változatot kizárja.	dai-os=1700000
dai-ot	HLS	A dai-ov paraméter által megadott értékek típusát leíró rendezési információ. Lehet „bw”, amely a sávszélességet jelöli (legközelebbi egyezés) VAGY lehet sávszélesség és felbontás alapú rendezés (pontos egyezés). Vagy a sávszélességet, vagy a felbontást mindenképpen meg kell adni. Az alapértelmezett érték a „bw”. Ha a dai-ot paraméter meg van adva, a dai-ov azonban nincs, akkor a lejátszási lista az összes változatot az eredeti sorrendben adja vissza.	dai-ot=bw dai-ot=bw_res
dai-ov	HLS	Vesszővel elválasztott értékek, amelyek a visszaküldendő multimédiás lejátszási listák sorrendjét határozzák meg. A dai-ot paraméterrel együtt kell használni, és mindegyik értéknek ugyanolyan, a dai-ot paraméter által leírt típusúnak kell lennie. Az audiováltozatot a speciális „audio” értékkel lehet megadni. Ha a sorrendben több változat értéke is ugyanaz (például két változat sávszélességének értéke ugyanaz, de a felbontásuk eltérő), akkor megmarad a változatok eredeti sorrendje.	dai-ot=bw&dai-ov=2025837,1406061 dai-ot=bw_res&dai-ov=1400000:640x360,audio
dai-sr	HLS, DASH	A visszaküldendő videóváltozatok sávszélesség-tartománya. Az összes magasabb sávszélesség kiválasztásához csak a startBandwidth paramétert határozza meg. Az összes alacsonyabb sávszélesség kiválasztásához csak az :endBandwidth paramétert határozza meg (kettőspont, vagyis „:” előtaggal). A sávszélesség kényszerítése csak a videótartalomra vonatkozik.	dai-sr=1300000:2500000

Egyéb felülbírálási paraméterek

Paraméter	Streamprotokoll	Leírás	Példák
dai-ah	HLS, DASH	Meghatározza, hogy az élő közvetítésben legyen-e hirdetési szünet. A hirdetési szünet időtartamát meg kell határozni az élő közvetítésben.	Hirdetési szünet engedélyezése: dai-ah=1
dai-apto  (Béta)	HLS, DASH	A hirdetési podra vonatkozó döntéshozatal időkorlátja (ezredmásodpercben) VOD és élő közvetítés létrehozásakor. Ez az érték a tartalom létrehozásakor hozott, tartalom közbeni vagy pedig tartalom utáni hirdetésszünetre vonatkozó döntésnél használható (nem jövőbeli minden hirdetési döntésnél a stream létrehozása után). Múltbéli hirdetésszünetek esetén csak EVENT típusú lejátszási lista vagy a dai-dpb paraméter használatakor áll rendelkezésre. A beállítás értéke 0-nál nagyobb, de legfeljebb 10 000 lehet. Túl alacsony vagy túl magas érték beállítása befolyásolhatja a hirdetéskitöltést vagy a felhasználói élményt.	dai-apto=4000
dai-dpb	HLS, DASH	Meghatározza, mikor engedélyezze a múltbéli hirdetésszünetre vonatkozó döntéshozatalt a nem-SSB lineáris közvetítéseknél (az SSB-közvetítéseknél ezt a paramétert figyelmen kívül hagyja a rendszer). Ha engedélyezve van, a múltbéli hirdetésszüneteket a tartalom közbeni hirdetésekre vonatkozó döntések alapján töltik ki. Ez hatással lehet az indítási várakozási időre, amely a dai-apto paraméterrel szabályozható. A múltbéli hirdetészszünetek csak akkor kerülnek megtekintésre, ha a felhasználó visszateker, amely megnövelheti a kódmegjelenítések számát.	A múltbéli hirdetésszünetekre vonatkozó döntéshozatal engedélyezése: dai-dpb=true A múltbéli hirdetésszünetekre vonatkozó döntéshozatal tiltása HLS EVENT típusú lejátszási listáknál: dai-dpb=false
dai-dvr	HLS, DASH	Az élő tartalom és a hirdetések DVR-időtartama (másodpercben), ameddig a felhasználó vissza tud tekerni a lejátszás megzavarása nélkül.  Az alapértelmezett érték jelenleg 100 másodperc, illetve az élő közvetítés beállításakor megadott érték. Azonban minden élő közvetítésnél megadható új maximális érték, amely SSB esetén legfeljebb 100 másodperc, az SDK vagy az API használatakor pedig 1800 másodperc lehet. Ha hosszabb DVR-időtartamot szeretne megadni, vegye fel a kapcsolatot fiókkezelőjével. Útmutató és használat A visszaküldött lejátszási lista tényleges DVR-időtartama az alapul szolgáló szegmensek időtartamától függően kissé hosszabb vagy rövidebb lehet. Emellett a változatok között is lehetnek kisebb eltérések. A tényleges időintervallum maximális értéke nem lehet nagyobb az eseménynél megadott DVR-időtartam értékénél. Ha mégis nagyobb, akkor az értéket automatikusan korlátozza a rendszer. Az SSB-streamek DVR-időtartamai is alacsonyabb értékre vannak korlátozva az SDK- vagy a nyilvános API-streamek értékéhez képest. Habár mindent megteszünk annak érdekében, hogy kompatibilis manifestet küldjünk vissza, nagyon alacsony vagy nagyon magas érték megadása problémákat okozhat a lejátszás során. A lejátszást alaposan tesztelni kell a kívánt DVR-időtartammal, hogy biztosan megfelelően működjön minden. Kerülje eltérő időtartamok használatát a különböző eszközökön. Ha az egyik eszközön 30, míg másokon 31 vagy 35 másodperces időtartamot ad meg, az a teljesítmény szempontjából nem megfelelő. Ehelyett használjon időtartamcsoportokat (pl. 35 másodpercet az egyik eszközcsoport, 10 percet egy másik eszközcsoport esetében stb.). Ez hatékonyabb erőforrás-elosztást és jobb teljesítményt eredményez.	dai-dvr=60
dai-emsgv	HLS	Az eseményüzenet-verzió (Event Message version) egy streamlétrehozási paraméter, amely lehetővé teszi a hívók számára az „emsg” verziók meghatározását a CMAF (Common Media Application Format)-tartalmakhoz. A HLS-szabvány az „emsg” 1. verzióját követeli meg. Ez a beállítás azon platformok esetén hasznos, amelyek nem támogatják a szabványos 1-es verziót, és a 0-s verzióra van szükségük (ilyen például a Roku).	dai-emsgv=1
dai-pre (Béta)	HLS, DASH	Meghatározza, hogy egy olyan élő közvetítésnél, amelynél engedélyezve van a tartalom előtti hirdetés, tartalom előtti hirdetéseket kell-e megjelenítenie a tartalom közbeni hirdetések helyett abban az esetben, ha átfedésben vannak egymással. Az alapértelmezett viselkedés az átfedésben lévő tartalom közbeni hirdetést jeleníti meg a tartalom előtti hirdetés helyett.	dai-pre=1

Példák a paraméterek felülírására

Az összes kibontása  Az összes összecsukása

Két változat kiválasztása

Kérelem

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

Válasz

#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
 

Egy audiováltozat és egy videóváltozat kiválasztása

Kérelem

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

Válasz

#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
 

Egyeztetés sávszélesség és felbontás alapján

Kérelem

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

Válasz

#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
 

Egyeztetés sávszélesség-tartomány alapján

Kérelem

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

Válasz

#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
 

Kezdő sávszélesség megadása

Kérelem

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

Válasz

#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
 

Feliratok kizárása

Eredeti manifest feliratokkal

#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
 

Kérelem

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

Válasz

#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
 

Kodekek kizárása

Eredeti manifest ac‑3 vagy eac‑3 kodekkel

#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
 

Egyetlen kodek kizárása

Kérelem

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

Válasz

#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
 

Több kodek kizárása

Kérelem

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

Válasz

#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
 

A DAI hibaelhárításával vagy szolgáltatáskimaradásaival kapcsolatos problémák esetén forduljon a megjelenítői ügyfélszolgálathoz.