Akış parametrelerini geçersiz kılma

Akış parametrelerinin geçersiz kılınması isteğe bağlıdır. HLS veya DASH oynatma listesi istendiğinde oynatıcının veya uygulamanın bir akış oluşturma parametresinin varsayılan değerini geçersiz kılmasını ya da varyantların seçimini veya varsayılan sırasını geçersiz kılmasını istemeniz hâlinde kullanılabilir. Bu parametreleri IMA SDK, Sunucu Tarafı İşaretleme (SSB) ve DAI API'si uygulamaları için oynatıcıdan veya uygulamadan iletebilirsiniz.

Ayrıca diğer varsayılan reklam etiketi parametrelerini geçersiz kılabilirsiniz.

Varyant seçimini ve sırasını geçersiz kılma

Varsayılan oynatma listesi sırası yayıncı tarafından belirlenir. Herhangi bir sıralama parametresi belirtilmezse oynatma listeleri, yayıncı tarafından döndürülen orijinal sırayla döndürülür.

Akış oluşturma sırasında belirtilen varyant seçimi ve sırası parametrelerini geçersiz kılabilirsiniz. Bunu yapmak, bir ana oynatma listesi isteğine verilen yanıta dahil edilmesi gereken varyant alt kümesini ve bu varyantların sırasını belirtmenize olanak tanır. Bu, içeriği tüketen kullanıcıya bağlı olarak başka bir varyant yerine belirli bir varyanta öncelik verilmesini istediğiniz durumlarda faydalı olabilir.

Varyant alt kümesi ve sırası, akışın ömrü boyunca aynı kalır. Parametreler IMA SDK kullanılırken adTagParameters yapısının bir parçası olarak, DAI API'si parametreleri olarak ya da SSB kullanılırken ek HTTP GET parametreleri olarak kabul edilir.

Parametre	Akış protokolü	Açıklama	Örnekler
dai-aor	HLS, DASH	Döndürülecek ses varyantları için bant genişliği aralığı. Tüm yüksek bant genişliklerini seçmek için yalnızca startBandwidth'i belirtin. Daha düşük olan bant genişliklerini seçmek için yalnızca :endBandwidth'i [önünde iki nokta (":") bulunur] belirtin.	dai-aor=60000
dai-dlid	HLS, DASH	Seç-izle video içeriğiniz için CDN yapılandırması oluşturduğunuzda, varsayılan CDN yapılandırması ve ek CDN yayınlanma ayarları tanımlayın. Bu, oturumun başında anahtar/değer çifti kullanarak birden fazla CDN oluşturmanıza ve hangisinden yayın yapılacağını dinamik olarak seçmenize olanak tanır. CDN yapılandırmalarınızı oluşturduktan ve kaydettikten sonra Ad Manager her bir yapılandırmanıza ad atar. Bu ad, dai-dlid parametresinin bir değeri olarak akış oluşturma isteğine iletilmelidir. İsteğe herhangi bir ad iletilmezse Ad Manager varsayılan CDN'yi kullanır.	dai-dlid=AaBbC1aaBa0obA1BABaaBA (AaBbC1aaBa0obA1BABaaBA, Ad Manager'da görünen addır)
dai-excl	HLS, DASH	Oynatma listesinden hariç tutulacak oluşturmalar. subtitles, codec, audio-lang, subtitle-lang, iframe ve resolution'u destekler. Tek bir değeri veya birden fazla değerin virgülle ayrılmış listesini kullanarak çözünürlüğü, ses codec'lerini, video codec'lerini ve ses ve/veya altyazı dillerini hariç tutabilirsiniz. Codec öneki, "*" son ekiyle de desteklenir. Bu son ek, verilen ön ekle codec içeren tüm oluşturmalar hariç tutulur.	dai-excl=subtitles dai-excl=iframe Tek codec dai-excl=codec:ec-3 Birden fazla codec dai-excl=codec:ec-3,codec:ac-3 Önek codec'i dai-excl=codec:avc1* Tek dilde ses dai-excl=audio-lang:en Tek dilde altyazı dai-excl=subtitle-lang:en Birden fazla seçim dai-excl=audio-lang:en, audio-lang:es, subtitle-lang:en, subtitle-lang:es Çözünürlük dai-excl=resolve:480x272
dai-os	HLS	Ana oynatma listesinin üst kısmına yerleştirilecek video varyantı bant genişliği. startBandwidth değerine en yakın varyant seçilir. İki değer de eşit uzaklıktaysa en düşük değer seçilir. Bu parametre sağlandığında ve dai-aor sağlanmadığında yalnızca ses varyantlarının tümü hariç tutulur.	dai-os=1700000
dai-ot	HLS	dai-ov parametresi tarafından belirtilen değerlerin türünü açıklayan sipariş türü bilgileri. Sıralamaya göre bant genişliğini belirtmek için "bw" (en yakın eşleşme) VEYA bant genişliği + çözünürlük (tam eşleşme) olmalıdır. Bant genişliği veya çözünürlükten en az biri belirtilmelidir. Varsayılan değer "bw"dir. dai-ot parametresi belirtilmiş ancak dai-ov belirtilmemişse oynatma listesi tüm varyantları orijinal sırayla döndürür.	dai-ot=bw dai-ot=bw_res
dai-ov	HLS	Döndürülecek medya oynatma listelerinin sırasını belirten virgülle ayrılmış değerler. Bu değerler dai-ot ile birlikte kullanılmalı ve her değer, dai-ot parametresi tarafından açıklananla aynı türde olmalıdır. Ses varyantını belirtmek için "audio" özel değeri kullanılabilir. Aynı sıra değerine sahip birden çok varyant varsa (örneğin, aynı bant genişliğine fakat farklı çözünürlüklere sahip iki varyant) bu varyantlarda orijinal sıra korunur.	dai-ot=bw&dai-ov=2025837,1406061 dai-ot=bw_res&dai-ov=1400000:640x360,audio
dai-sr	HLS, DASH	Döndürülecek video varyantları için bant genişliği aralığı. Tüm yüksek bant genişliklerini seçmek için yalnızca startBandwidth'i belirtin. Tüm düşük bant genişliklerini seçmek için yalnızca :endBandwidth'i [önünde iki nokta (":") bulunur] belirtin. Bant genişliği uygulaması yalnızca video içeriği için geçerlidir.	dai-sr=1300000:2500000

Diğer geçersiz kılma parametreleri

Parametre	Akış protokolü	Açıklama	Örnekler
dai-ah	HLS, DASH	Bir canlı yayına reklam tatili uygulamak gerekip gerekmediğini belirtir. Canlı yayın yapılandırmasında reklam tatili süresi belirtilmelidir.	Reklam tatilini etkinleştirme: dai-ah=1
dai-apto  (Beta)	HLS, DASH	VOD ve canlı yayın oluşturma için reklam kapsülü karar zaman aşımı (milisaniye cinsinden). Bu değer, akış oluşturulurken ortaya çıkan ara kararında veya geçmiş ara kararında kullanılır (akış oluşturulduktan sonra gelecekteki hiçbir reklam kararı için kullanılmaz). Geçmiş reklam araları için bu özellik yalnızca EVENT türündeki oynatma listeleri veya dai-dpb parametresi kullanıldığında geçerlidir. Bu, 0'dan büyük ve en fazla 10.000 olan bir değere ayarlanabilir. Çok düşük veya yüksek bir değerin ayarlanması, reklam doluluğunu veya kullanıcı deneyimini etkileyebilir.	dai-apto=4000
dai-dpb	HLS, DASH	SSB dışı doğrusal akışlar için geçmiş ara kararının etkinleştirilip etkinleştirilmeyeceğini belirtir (parametre SSB akışları için yok sayılır). Etkinleştirilmesi hâlinde, geçmiş aralar için ara ortası kararları ile karar verilir. Bu, başlangıç gecikmesini etkileyebilir. Başlangıç gecikmesini dai-apto parametresiyle kontrol edebilirsiniz. Kullanıcı geri sarma işlemi yapmadıkça geçmiş aralar görüntülenmez. Bu nedenle, kod sunma sayıları artabilir.	Geçmiş ara kararını etkinleştir: dai-dpb=true HLS EVENT türü oynatma listeleri için geçmiş ara kararını devre dışı bırak: dai-dpb=false
dai-dvr	HLS, DASH	Kullanıcının geri kaydırıp kesintisiz oynatmaya devam edebileceği canlı içeriğin ve reklamların DVR süresi (saniye cinsinden).  Bu değer için geçerli varsayılan süre, 100 saniyedir veya canlı yayın ayarı sırasında belirtilen değerdir. Ancak SSB için en fazla 100 saniye veya SDK ya da API kullanıldığında 1.800 saniye olmak üzere her canlı yayın için yeni bir maksimum değer belirtilebilir. Daha uzun bir DVR süresi istiyorsanız hesap yöneticinize başvurun. Rehberlik ve kullanım Döndürülen oynatma listesinin gerçek DVR süresi, alttaki segmentlerin süresine bağlı olarak biraz daha uzun veya kısa olabilir. Bu, varyantlar arasında da bir miktar farklılık gösterebilir. Gerçek aralığın maksimum değeri, etkinlikte belirtilen DVR aralığı değerinden büyük olmamalıdır. Aksi takdirde, değer otomatik olarak sınırlandırılır. SSB akışlarının DVR aralıkları da SDK veya Genel API akışlarına kıyasla daha düşük bir değerle sınırlandırılır. Uyumlu bir manifest döndürmek için elimizden geleni yapsak da çok küçük veya çok büyük bir değer belirtmek oynatma sırasında sorunlara neden olabilir. Her şeyin sorunsuz işlediğinden emin olmak için oynatmanın istenen DVR aralığı süresiyle ayrıntılı bir şekilde test edilmesi gerekir. Cihazlarda farklı aralıklar kullanmaktan kaçının. Bir cihazda 30 saniyelik, diğer cihazlarda 31 veya 35 saniyelik bir aralık boyutu belirtmek performans açısından uygun değildir. Bunun yerine aralık gruplarını kullanın (ör. bir cihaz grubu için 35 saniye, başka bir grup için 10 dakika vb.). Bu daha etkin kaynak ayırmayı ve performansı olanaklı kılar.	dai-dvr=60
dai-emsgv	HLS	Etkinlik Mesajı sürümü, arayanların Ortak Medya Uygulaması Biçimi (CMAF) içeriği için "emsg" sürümlerini belirtmesini sağlayan bir akış oluşturma parametresidir. HLS standardı için "emsg" sürüm 1 gerekir. Bu ayar, Roku gibi standart sürüm 1'i desteklemeyen ve sürüm 0'a ihtiyaç duyan platformlar için kullanışlıdır.	dai-emsgv=1
dai-pre (Beta)	HLS, DASH	Videodan önce gösterilen reklamın etkinleştirildiği bir canlı yayında, çakışmaları hâlinde videonun ortasında gösterilen reklam yerine videodan önce gösterilen reklam gösterilip gösterilmeyeceğini belirtir. Varsayılan davranış, videodan önce gösterilen reklam yerine çakışan videonun ortasında gösterilen reklamı göstermektir.	dai-pre=1

Parametre geçersiz kılma örnekleri

Tümünü genişlet  Tümünü daralt

İki varyant seçme

İste

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

Yanıt

#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
 

Bir ses varyantı ve bir video varyantı seçme

İste

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

Yanıt

#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
 

Bant genişliği ve çözünürlüğe göre eşleştirme

İste

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

Yanıt

#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
 

Bant genişliği aralığına göre eşleştirme

İste

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

Yanıt

#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
 

Başlangıç bant genişliği belirtme

İste

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

Yanıt

#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
 

Altyazıları hariç tutma

Altyazılı orijinal manifest

#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
 

İste

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

Yanıt

#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
 

Codec'leri hariç tutma

ac-3, eac-3 ile orijinal manifest

#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
 

Bir codec'i hariç tutma

İste

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

Yanıt

#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
 

Birden fazla codec'i hariç tutma

İste

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

Yanıt

#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
 

DAI sorunlarını giderme veya kesintilerle ilgili konular için yayıncı destek ekibiyle iletişime geçin.