您可視需求選擇覆寫串流參數。
如果想讓播放器或應用程式覆寫下列設定,就可以執行這項動作:
- 串流建立參數的預設值
- 請求 HLS 或 DASH 播放清單時,變體的選取順序或預設順序
您可以從播放器或應用程式傳遞這些參數,以便導入 IMA SDK、伺服器端信標 (SSB) 和 DAI API。
覆寫變體選項和順序
預設的播放清單順序是由發布商決定。如果沒有指定順序參數,播放清單會依照發布商設定的原始順序傳回。
您可覆寫在建立串流時指定的變體選項和順序參數,自行決定應加入主要播放清單請求的一部分變體,以及這些變體的順序。如果想要依據讀取內容的使用者來調高某個特定變體的優先級,這項功能會對您非常有幫助。
變體的子集和順序在串流播放時將全程維持一致。使用 IMA SDK 和 DAI API 參數時,系統會接受這些參數並將其視為 adTagParameters 架構的一部分。使用 SSB 時,系統會將參數視為額外的 HTTP GET
參數
參數 | 串流通訊協定 | 說明 | 範例 |
---|---|---|---|
dai-aor |
HLS、DASH |
要傳回的音訊變體頻寬範圍。
|
|
dai-dlid |
HLS、DASH |
為影片素材資源建立 CDN 設定時,請指定預設的 CDN 設定和其他的 CDN 放送設定。這樣您就能設定多個 CDN,並在工作階段開始時,透過鍵/值動態選擇要使用的 CDN。 設定並儲存 CDN 設定後,Ad Manager 會為每個設定指派名稱。這個名稱應該做為 如果沒有任何名稱傳入請求,Ad Manager 會使用預設的 CDN。 注意:如果單一內容有多個放送位置不同的 CDN,可以為 |
( |
dai-excl |
HLS、DASH | 要從播放清單中排除的顯示項目。支援 subtitles 、codec 、audio-lang 、subtitle-lang 、iframe 和 resolution 。您可以使用單一值或包含多個值的逗號分隔清單來排除解析度、音訊轉碼器、視訊轉碼器,以及音訊和/或字幕語言。Codec 前置字元也支援後置字元「*」,這會排除所有具備所提供前置字元的 codec 顯示項目。 |
單一轉碼器 多個轉碼器 前置字元轉碼器 單一語言音訊 單一語言字幕 多個選項 解析度 |
dai-os |
HLS | 放置在主要播放清單頂端的視訊變體頻寬。系統會選取與 startBandwidth 值最接近的變體。如果兩個值等距,系統會選取最低值。當系統提供這個參數而不是 dai-aor ,所有僅限音訊的變體都會遭到排除。 |
dai-os=1700000 |
dai-ot |
HLS |
這項順序類型資訊會說明由 如果指定了 |
dai-ot=bw dai-ot=bw_res |
dai-ov |
HLS |
指定媒體播放清單傳回順序的半形逗號分隔值。必須與 如果多個變體具有相同的順序值 (例如有兩個變體具有相同的頻寬,但解析度不同),這些變體之間會維持原始的順序。 |
|
dai-sr |
HLS、DASH |
要傳回的視訊變體頻寬範圍。如要選取所有較高的頻寬,請單單指定 頻寬強制執行僅適用於影片內容。
|
dai-sr=1300000:2500000 |
其他覆寫參數
參數 | 串流通訊協定 | 說明 | 範例 |
---|---|---|---|
dai-ah |
HLS、DASH | 指定直播活動是否應套用廣告休播。您必須在直播活動設定中指定廣告休播時間長度。 | 啟用廣告休播:dai-ah=1 |
dai-apto (Beta 版) |
HLS、DASH |
用於建立 VOD 和直播活動的廣告連播決策逾時 (以毫秒為單位)。 這個值適用於串流建立過程中做出的所有封鎖廣告決策,包含線性片中廣告插播和過往廣告插播決策,以及隨選影片的 VMAP 決策。但是,只有在使用 EVENT 類型播放清單或 dai-dpb 參數時,才適用於過去的廣告插播。 可設為任何大於 0 且小於或等於 10000 的值。
將這個值設得太低或是太高,可能會對廣告供應或使用者體驗造成影響。 |
dai-apto=4000 |
dai-dpb |
HLS、DASH |
指定是否要為非-SSB 線性串流播放啟用過去的廣告插播裁決功能 (SSB 串流播放會忽略此參數)。如果啟用此功能,過去的廣告插播會透過置中的廣告插播進行裁決。 這個設定可能會對啟動延遲造成影響,而您可透過 除非使用者倒轉影片,否則過去的廣告插播會一直是未經瀏覽的廣告,而此舉可能會造成程式碼調用次數增加的情況。 |
啟用過去的廣告插播裁決功能:dai-dpb=true 為 HLS EVENT 類型播放清單停用過去的廣告插播裁決功能: dai-dpb=false |
dai-dvr |
HLS、DASH | 直播內容和廣告的 DVR 時間長度 (以秒為單位),可讓使用者向後捲動並保持順暢的播放體驗。 這個值目前預設為 100 秒,或是在直播設定期間指定的值。不過,可以為每個直播活動指定新的上限;SSB 最高為 100 秒,而使用 SDK 或 API 則為 1800 秒。如需較大的 DVR 播放時間,請與您的客戶經理聯絡。 |
dai-dvr=60 |
dai-emsgv |
HLS |
「事件訊息」版本是串流建立參數,可讓呼叫者指定 Common Media Application Format (通用媒體應用格式,CMAF) 內容的「emsg」版本。 HLS 標準必須使用「emsg」版本 1。 這項設定適用於不支援標準版本 1,且需要版本 0 (例如 Roku) 的平台。
|
dai-emsgv=1 |
dai-pre (Beta 版) |
HLS、DASH | 指定已啟用片頭廣告的直播是否應在重疊時顯示片頭廣告,而非片中廣告。預設行為是顯示重疊的片中廣告,而非片頭廣告。 | dai-pre=1 |
dai-ad-dlid (Beta 版) |
HLS、DASH |
指定您在 Google Ad Manager 預先設定的外部 CDN 專屬名稱,以便在直播內容中放送廣告。 進一步瞭解如何透過外部 CDN 放送廣告。 |
( |
dai-aup (Beta 版) |
HLS、DASH |
指定任意網址前置字元,指向用來建構廣告區隔網址的外部 CDN,以便在直播內容中放送廣告。 進一步瞭解如何透過外部 CDN 放送廣告。 |
dai-aup=https://domain.com/path-c1/path-c2 |