AdsRequest

新的 AdsRequest()

實作

google.ima.AdsRequestInterface

adTagUrl

字串

指定廣告伺服器要求的廣告代碼網址。 如要進一步瞭解如何建構廣告代碼網址，請參閱 手動建立主要廣告影片廣告代碼一文。

此為必要參數。

AdsResponse

(空值、字串或非空值文件)

指定 VAST 2.0 文件做為廣告回應，而不是透過廣告代碼網址發出請求。這項功能對於偵錯和其他已提供 VAST 回應的情況來說非常實用。

此參數為選用項目。

內容時間長度

(空值或數字)

指定要顯示的內容時間長度 (以秒為單位)。用於 2 種情況：1) AdX 廣告指定目標，以及 2) 決定預先載入 VMAP 片尾的時機。

此參數為選用項目。

內容關鍵字

(空值或非空值陣列)

指定要用來呈現內容的關鍵字。用於 AdX 請求。

此參數為選用項目。

內容標題

(空值或字串)

指定要顯示內容的標題。用於 AdX 請求。

此參數為選用項目。

非線性完整版位

布林值

強制讓非線性 AdSense 廣告顯示為線性全版位廣告。設定完成後，內容影片就會暫停，而非線性文字或圖像廣告則會以全版位的形式顯示。略過或關閉廣告後，內容影片就會繼續播放。

線性廣告版位高度

數字

指定要顯示線性廣告矩形的高度。這個值是其中一項廣告選擇條件之一。 這個值不需要與實際廣告高度一致。

此為必要參數。

線性廣告版位寬度

數字

指定顯示線性廣告的矩形區域寬度。這個值是其中一項廣告選擇條件之一。 這個值不需要與實際廣告寬度一致。

此為必要參數。

liveStreamPrefetchSeconds

數字

指定在呼叫 adAds 後，要請求廣告代碼網址之前的等待時間上限 (以秒為單位)。這可用於在直播活動期間標記要求，以便減少要求數量激增。

非線性廣告版位高度

數字

指定非線性廣告的矩形區域高度。這個值是其中一項廣告選擇條件。這個值不需要與實際廣告高度一致。

此為必要參數。

非線性廣告版位寬度

數字

指定顯示非線性廣告的矩形區域寬度。這個值是其中一項廣告選擇條件。這個值不需要與實際廣告寬度一致。

此為必要參數。

omidAccessModeRules

含有字串屬性的非空值物件

將驗證供應商對應至 OMID 存取模式的設定物件。鍵必須是 google.ima.OmidVerificationVendor 中的值，且值必須是 google.ima.OmidAccessMode 中的值。

驗證指令碼網址在內部會與規則運算式提供，並解析為 OmidVerificationVendor 金鑰。接著，IMA 會查詢使用此物件給指定供應商的存取模式。

如果指令碼網址無法解析為已知的供應商，或是這個物件未提供已解決的 OmidVerificationVendor，IMA 會使用 OmidVerificationVendor 提供的存取模式。如未提供 OmidVerificationVendor.OTHER，系統則會使用 LIMITED 存取模式。

網頁網址

(空值或字串)

指定要在 Google 廣告請求中加入的網頁網址，以便做為指定目標。網址必須是有效的網址。指定後，這個值會用於 [PAGEURL] VAST 巨集。

此參數為選用項目。

VAST 逾時

數字

覆寫單一包裝函式的預設 VAST 載入逾時 (以毫秒為單位)。逾時預設為 5000 毫秒。

此參數為選用項目。

設定 AdllAutoPlay

setAdWillAutoPlay(autoPlay) 會傳回 void

告知 SDK 是否要為了回應使用者動作而啟動內容與廣告，或是是否會自動播放。變更這項設定不會影響廣告播放。

傳回

void 

setAdllPlay 靜音

setAdWillPlaysilentd(靜音) 會傳回無效

通知 SDK 是否要在播放器設為靜音的情況下開始播放廣告。 變更這項設定不會影響廣告播放，但是會在廣告請求中傳送適當的信號，讓買方針對忽略的廣告空間出價。

傳回

void 

設定連續播放

set 連續 Playback(連續播放) 傳回 void

告知 SDK 是否打算繼續播放另一部與電視廣播類似的內容影片。變更為此設定不會影響廣告播放，但在廣告請求中會傳送適當的信號，讓買方可以對廣告空間類型出價。

傳回

void