Penggantian parameter streaming bersifat opsional. Fitur ini tersedia jika Anda ingin pemutar atau aplikasi mengganti nilai default parameter pembuatan streaming, atau mengganti pilihan atau urutan default varian saat playlist HLS atau DASH diminta. Anda dapat meneruskan parameter ini dari pemutar atau aplikasi untuk penerapan IMA SDK, Server-Side Beaconing (SSB), dan DAI API.
Mengganti pilihan dan urutan varian
Urutan playlist default ditentukan oleh penayang. Jika tidak ada parameter pengurutan yang ditentukan, playlist akan ditampilkan dalam urutan asli, sebagaimana yang ditampilkan oleh penayang.
Anda dapat mengganti pilihan varian dan parameter urutan yang ditentukan selama pembuatan streaming, yang memungkinkan Anda menentukan subbagian varian yang harus disertakan dalam respons terhadap permintaan playlist master dan urutan varian tersebut. Tindakan ini mungkin berguna jika Anda ingin agar varian tertentu didahulukan berdasarkan pengguna yang menikmati konten.
Subbagian dan urutan varian tetap sama selama masa aktif streaming. Parameter diterima sebagai bagian dari struktur adTagParameters saat menggunakan parameter IMA SDK, DAI API, atau sebagai parameter GET
HTTP tambahan saat menggunakan SSB.
Parameter | Protokol streaming | Deskripsi | Contoh |
---|---|---|---|
dai-aor |
HLS, DASH | Rentang bandwidth untuk varian audio yang akan ditampilkan. Untuk memilih semua bandwidth yang lebih tinggi, hanya tentukan startBandwidth . Untuk memilih semua bandwidth yang lebih rendah, hanya tentukan :endBandwidth (diawali dengan tanda titik dua ":"). |
dai-aor=60000 |
#dai-dpb |
HLS, DASH |
Saat membuat konfigurasi CDN untuk konten video on demand, Anda memiliki opsi untuk menentukan konfigurasi CDN default, dan setelan penayangan CDN tambahan. Hal ini memungkinkan Anda menyiapkan lebih dari satu CDN dan memilih tempat penayangan CDN secara dinamis pada awal sesi dengan menggunakan nilai kunci. Setelah Anda menyiapkan dan menyimpan konfigurasi CDN, Ad Manager akan memberikan nama untuk setiap konfigurasi. Nama ini harus diteruskan ke dalam permintaan pembuatan streaming sebagai nilai parameter Jika tidak ada nama yang diteruskan ke permintaan, Ad Manager akan menggunakan CDN default. |
( |
dai-excl |
HLS, DASH | Rendisi yang akan dikecualikan dari playlist. Mendukung subtitles , codec , audio-lang , subtitle-lang , iframe , dan resolution . Anda dapat mengecualikan resolusi, codec audio, codec video, serta bahasa audio dan/atau subtitel menggunakan satu nilai atau daftar beberapa nilai yang dipisahkan koma. Awalan codec juga didukung dengan akhiran "*", yang mengecualikan semua rendisi dengan codec yang berisi awalan yang diberikan. |
Satu codec Beberapa codec Codec awalan Audio satu bahasa Subtitel satu bahasa Beberapa pilihan Resolusi |
dai-os |
HLS | Bandwidth varian video yang akan ditempatkan di bagian atas playlist master. Varian yang nilainya paling dekat dengan startBandwidth dipilih. Jika dua nilai sama jauhnya, nilai yang paling rendah dipilih. Jika parameter ini disediakan, dan dai-aor tidak, semua varian hanya audio akan dikecualikan. |
dai-os=1700000 |
dai-ot |
HLS |
Informasi jenis urutan yang menjelaskan jenis nilai yang ditentukan oleh parameter Jika parameter |
dai-ot=bw dai-ot=bw_res |
dai-ov |
HLS |
Nilai yang dipisahkan koma yang menentukan urutan playlist media yang akan ditampilkan. Harus digunakan bersama dengan Jika ada beberapa varian dengan nilai urutan yang sama (misalnya, dua varian memiliki bandwidth yang sama namun resolusinya berbeda-beda), urutan aslinya akan dipertahankan untuk varian tersebut. |
|
dai-sr |
HLS, DASH |
Rentang bandwidth untuk varian video yang akan ditampilkan. Untuk memilih semua bandwidth yang lebih tinggi, hanya tentukan Penerapan bandwidth hanya untuk konten video.
|
dai-sr=1300000:2500000 |
Parameter penggantian lain
Parameter | Protokol streaming | Deskripsi | Contoh |
---|---|---|---|
dai-ah |
HLS, DASH | Menentukan apakah live stream harus menerapkan reses iklan atau tidak. Durasi reses iklan harus ditentukan dalam konfigurasi live stream. | Aktifkan reses iklan:dai-ah=1 |
dai-apto (Beta) |
HLS, DASH |
Waktu tunggu pengambilan keputusan pod iklan untuk pembuatan VOD dan live stream, dalam hitungan milidetik. Nilai ini digunakan dalam keputusan jeda iklan atau keputusan jeda sebelumnya yang terjadi saat streaming dibuat (tidak semua keputusan iklan berikutnya setelah streaming dibuat). Untuk jeda iklan sebelumnya, waktu tunggu hanya dapat digunakan saat menggunakan playlist jenis EVENT atau parameter dai-dpb. Hal Ini dapat disetel ke nilai yang lebih besar dari 0, dan kurang dari atau sama dengan 10000.
Menetapkan nilai yang sangat rendah atau tinggi dapat memengaruhi pengisian iklan atau pengalaman pengguna. |
dai-apto=4000 |
dai-dpb |
HLS, DASH |
Menentukan apakah akan mengaktifkan pengambilan keputusan jeda sebelumnya untuk streaming linier non-SSB (parameter diabaikan untuk streaming SSB). Jika diaktifkan, jeda sebelumnya akan ditentukan dengan keputusan jeda pertengahan. Hal ini dapat memengaruhi latensi pemulaian, yang dapat Anda kontrol dengan parameter Jeda sebelumnya tidak akan dilihat kecuali jika pengguna memutarnya ulang dan hal ini dapat meningkatkan jumlah kode yang ditayangkan. |
Aktifkan pengambilan keputusan jeda sebelumnya:dai-dpb=true Nonaktifkan pengambilan keputusan jeda sebelumnya untuk HLS playlist jenis EVENT: dai-dpb=false |
dai-dvr |
HLS, DASH | Durasi DVR (dalam detik) konten live dan iklan yang dapat di-scroll balik oleh pengguna dan yang mempertahankan pemutaran yang mulus.
Nilai default saat ini untuk nilai ini adalah 100 detik, atau nilai yang ditentukan selama penyiapan live stream. Namun, nilai maksimum yang baru dapat ditentukan untuk setiap live stream, hingga 100 detik untuk SSB, atau 1.800 detik jika menggunakan SDK atau API. Jika menginginkan durasi DVR yang lebih besar, hubungi Account Manager Anda. Panduan dan penggunaanDurasi DVR sebenarnya untuk playlist yang ditampilkan mungkin sedikit lebih atau kurang tergantung durasi segmen yang mendasarinya. Durasinya juga mungkin sedikit berbeda di berbagai varian. Nilai maksimum periode sebenarnya tidak boleh lebih besar dari nilai periode DVR yang ditentukan dalam peristiwa. Jika lebih besar, nilai akan dibatasi secara otomatis. Periode DVR untuk streaming SSB juga dibatasi ke nilai yang lebih rendah daripada streaming SDK atau Public API. Meskipun kami berupaya sebaik mungkin untuk menampilkan manifes yang kompatibel, penentuan nilai yang sangat kecil atau sangat besar dapat menyebabkan masalah dalam pemutaran. Pemutaran harus diuji secara menyeluruh dengan durasi periode DVR yang diinginkan untuk memastikan semuanya berfungsi sebagaimana mestinya. Hindari penggunaan periode yang berbeda di berbagai perangkat. Penentuan ukuran periode 30 detik untuk satu perangkat versus 31 detik atau 35 detik untuk perangkat lain tidak sesuai dari perspektif performa. Sebagai gantinya, gunakan bucket periode (misalnya, 35 detik untuk satu kumpulan perangkat, 10 menit untuk kumpulan lainnya, dll.). Tindakan ini memungkinkan performa dan alokasi resource yang lebih efisien. |
dai-dvr=60 |
dai-emsgv |
HLS |
Versi Event Message adalah parameter pembuatan streaming yang memungkinkan pemanggil menentukan versi "emsg" untuk konten Common Media Application Format (CMAF). Standar HLS memerlukan "emsg" versi 1. Setelan ini berguna untuk platform yang tidak mendukung versi standar 1 dan memerlukan versi 0, seperti Roku.
|
dai-emsgv=1 |
dai-pre (Beta) |
HLS, DASH | Menentukan apakah live stream yang mengaktifkan pre-roll harus menampilkan pre-roll, bukan mid-roll, jika terjadi tumpang-tindih. Perilaku default ini menampilkan iklan mid-roll yang tumpang-tindih, bukan pre-roll. | dai-pre=1 |
Contoh penggantian parameter
Permintaan
https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-ot=bw&dai-ov=2025837,1406061
Respons
#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
Permintaan
https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-ot=bw&dai-ov=audio,1406061
Respons
#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
Permintaan
https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-ot=bw_res&dai-ov=1400000:640x360,audio
Respons
#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
Permintaan
https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-sr=1300000:2500000&dai-aor=60000
Respons
#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
Permintaan
https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-os=1700000
Respons
#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
Manifes asli dengan subtitel
#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
Permintaan
https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-excl=subtitles
Respons
#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
Manifes asli dengan 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
Mengecualikan satu codec
Permintaan
http://truman.com/ssai/event/<event_code>/master.m3u8?dai-excl=codec:ec-3
Respons
#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
Mengecualikan beberapa codec
Permintaan
http://truman.com/ssai/event/<event_code>/master.m3u8?dai-excl=codec:ec-3,codec:ac-3
Respons
#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