Akış parametrelerinin geçersiz kılınması isteğe bağlıdır.
Oynatıcının veya uygulamanın aşağıdakileri geçersiz kılmasını isterseniz bu parametre kullanılabilir:
- Akış oluşturma parametresinin varsayılan değeri
- HLS veya DASH oynatma listesi istendiğinde varyantların seçimi veya varsayılan sırası.
Bu parametreleri IMA SDK, Sunucu Tarafı İşaretleme (SSB) ve DAI API'si uygulamaları için oynatıcıdan veya uygulamadan iletebilirsiniz.
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. Bu sayede, bir ana oynatma listesi isteğine verilen yanıta dahil edilen varyant alt kümesini belirtebilir ve bu varyantların sırasını belirleyebilirsiniz. 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ığı.
|
|
dai-dlid |
HLS, DASH |
Video öğeniz 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, İsteğe herhangi bir ad iletilmezse Ad Manager varsayılan CDN'yi kullanır. Not: |
( |
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. |
Tek codec Birden fazla codec Önek codec'i Tek dilde ses Tek dilde altyazı Birden fazla seçim Çözünürlük filtreleriTam çözünürlük Çözünürlük Aralığı:
Birden Fazla Çözünürlük/Çözünürlük Aralığı:
|
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-ot=bwdai-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 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-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 Bant genişliği zorunluluğu yalnızca video içerikleri 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 tüm engelleme reklam kararları için kullanılır (doğrusal yayınlarda ara ortası ve ara sonrası kararı, VOD'da VMAP kararları). 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. Varsayılan değer 5.000'dir (5 sn). Toplam akış oluşturma zaman aşımı 8 saniye veya dai-apto + 4 saniyedir. |
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 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=trueHLS 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ımDö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 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 |
dai-ad-dlid (Beta) |
HLS, DASH |
Reklamları canlı yayında yayınlamak için Google Ad Manager'da önceden yapılandırdığınız harici bir CDN'nin benzersiz adını belirtir. Reklamları harici CDN'ler aracılığıyla yayınlama hakkında daha fazla bilgi |
( |
dai-aup (Beta) |
HLS, DASH |
Reklamları canlı yayında yayınlamak için reklam segmenti URL'lerini oluşturmak üzere kullanılan harici bir CDN'yi işaret eden rastgele bir URL önekini belirtir. Reklamları harici CDN'ler aracılığıyla yayınlama hakkında daha fazla bilgi |
dai-aup=https://domain.com/path-c1/path-c2 |
Parametre geçersiz kılma örnekleri
İstek
https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-ot=bw&dai-ov=2025837,1406061Yanı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İstek
https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-ot=bw&dai-ov=audio,1406061Yanı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İstek
https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-ot=bw_res&dai-ov=1400000:640x360,audioYanı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İstek
https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-sr=1300000:2500000&dai-aor=60000Yanı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İstek
https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-os=1700000Yanı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.m3u8Altyazı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İstek
https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-excl=subtitlesYanı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.m3u8ac-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=YESBir codec'i hariç tutma
İstek
http://truman.com/ssai/event/<event_code>/master.m3u8?dai-excl=codec:ec-3Yanı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=YESBirden fazla codec'i hariç tutma
İstek
http://truman.com/ssai/event/<event_code>/master.m3u8?dai-excl=codec:ec-3,codec:ac-3Yanı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