getAdPosition

getAdPosition() 傳回數字

傳回廣告的位置。

傳回

number 廣告在廣告連播中的位置。傳回的值是以 1 為基礎，例如 2 之 1、2 之 2 等等。

getIs 串場廣告

getIs 串場廣告() 會傳回布林值

如果廣告為串場廣告，則傳回 True。串場廣告是一種簡短的線性廣告，可在使用者進入或離開廣告插播時間點時向使用者顯示。

傳回

boolean 廣告是否為串場廣告。

getMaxDuration

getMaxDuration() 會傳回數字

廣告連播的時間長度上限 (以秒為單位)。如果不明時間長度，則會傳回 -1。

傳回

number這個廣告連播中的廣告時間長度上限 (以秒為單位)。

getPodIndex

getPodIndex() 傳回數字

用戶端和 DAI VOD：傳回廣告連播的索引。如果是片頭廣告連播，則傳回 0。如果是片中廣告，傳回 1、2、...、北如果是片尾廣告廣告連播，則傳回 -1。如果這個廣告不屬於廣告連播，或這個廣告連播不屬於播放清單，則預設為 0。DAI 直播活動：一律傳回 -1。

傳回

number 廣告播放清單中的廣告連播索引。

getTimeOffset

getTimeOffset() 會傳回數字

傳回目前排定廣告連播的時間。針對包含動態插入廣告的 VOD 串流中的廣告連播，系統會傳回串流時間。

如果是片頭廣告連播，則會傳回 0。如果是片中廣告，系統會傳回排定的時間。如果是片尾廣告，則會傳回 -1。

如果這個廣告不屬於廣告連播，或廣告連播未加入廣告播放清單，則預設值為 0。

傳回

number 目前廣告連播的時間偏移。

getTotalAds 廣告

getTotalAds() 會傳回數字

這個廣告連播中包含的廣告總數 (包括串場廣告)。 串場廣告是一種簡短的線性廣告，可在使用者進入或離開廣告插播時間點時，向使用者指示。

如果這則廣告不屬於廣告連播，則預設值為 1。

在某些情況下，SDK 無法確定這個廣告連播中包含多少廣告。這些案例包括廣告連播，一個廣告代碼內包含多個廣告。在這些情況下，前幾個觸發的 AdEvents (AD_METADATA、LOADED 等) 可能只有播放清單回應中的廣告代碼總數。我們建議使用 FIRST_QUARTILE 事件做為事件，讓發布者從這個物件提取資訊，並更新播放器的視覺元素 (如果有的話)。

傳回

number 廣告連播中的廣告總數。