類別:StreamManager

建構函式

StreamManager

new StreamManager(videoElement、adUiElement、uiSettings)

參數

videoElement

要播放的 HTML 影片元素。

值不得為空值。

adUiElement

選用

用來存放廣告 UI 元素的 HTML 元素。這個元素的高度和寬度應與影片播放相同,且應直接重疊。如未提供,系統就不會顯示任何使用者介面,也不會要求不需要 UI 的廣告 (例如可略過的廣告)。

值不得為空值。

uiSettings

選用

這個串流使用的 UI 設定。

值不得為空值。

實作
EventTarget
擲回

方法

contentTimeForStreamTime

contentTimeForStreamTime(streamTime) 傳回數字

傳回指定串流時間不含廣告的內容時間。傳回直播指定的串流時間。

參數

streamTime

號碼

插入廣告的串流時間 (以秒為單位)。

傳回

number 廣告移除後與指定串流時間相對應的內容時間。

主軸

聚焦()

將焦點放在略過按鈕 (如果有的話)。如果沒有,則焦點會放在互動式元素,包括圖示或互動式廣告素材。

getAdSkippableState

getAd 可略過 State() 傳回布林值

如果廣告目前可以略過,則傳回 true。當這個值有所變更,StreamManager 會觸發 StreamEvent.SKIPPABLE_STATE_CHANGED 事件。

傳回

boolean 如果廣告目前可以略過,則為 True,否則為 false。

loadStreamMetadata

loadStreamMetadata()

要求 SDK 載入廣告中繼資料,然後播送 StreamEvent.LOADED。 從第三方影片拼接工具擷取串流資訊清單後,您應該手動觸發這個動作。這個類型僅適用於具有第三方影片拼接工具的 Pod 放送 VOD,其他串流要求免人工管理。

onTimedMetadata

onTimedMetadata(metadata)

傳送到已處理中繼資料的字典。字典預期鍵「TXXX」鍵以及使用者定義的中繼資料字串做為值。如果您的播放器提供原始中繼資料,請改為呼叫 StreamManager.processMetadata。

參數

中繼資料

物件

中繼資料字典。

值不得為空值。

previousCuePointForStreamTime

beforeCuePointForStreamTime(streamTime) 會傳回 CuePoint

傳回指定串流時間的上一個提示點。如果沒有這類提示點,則傳回空值。這會用於實作復原等功能,並在發布商偵測到使用者為了將使用者返回廣告插播時間點而搜尋時呼叫的功能。

參數

streamTime

號碼

要求的串流時間

傳回

nullable CuePoint 是指定串流時間的上一個提示點。

processMetadata

processMetadata(type, data, timestamp)

處理直播的中繼資料。如果您的影片播放器提供未剖析的中繼資料與時間戳記,請使用此欄位,否則請呼叫 StreamManager.onTimedMetadata。

參數

類型

字串

中繼資料類型。必須是 HLS 的「ID3」或是 DASH 的事件訊息配置 ID URI。

資料或曾存取這類資料的人員

(非空值 Uint8Array 或字串)

原始代碼資料。ID3 必須是完整的原始標記資料。如果是 DASH 事件訊息,這是指訊息資料字串。

時間戳記

號碼

處理資料的時間 (以秒為單位)。 對於 DASH,這是事件訊息開始時間。

replaceAdTagParameters

replaceAdTagParameters(adTagParameters)

針對即將放送的直播活動廣告請求,替換使用的所有廣告代碼參數。

參數

adTagParameters

含有字串屬性的物件

新的廣告代碼參數。 必須包含字串值。

值不得為空值。

requestStream

requestStream(streamRequest)

要求使用提供的串流參數載入串流。

參數

streamRequest

StreamRequest

包含用來載入串流中繼資料的參數。

值不得為空值。

重設

重設()

重設直播管理員,並移除任何持續進行的輪詢。

setClickElement

setClickElement(clickElement)

設定廣告點擊元素。廣告播放時,這個元素會用來當做點擊或輕觸接收器,而且可能會導致使用者離開目前頁面。現已淘汰,應改為將 adUiElement 傳入 StreamManager。如果為 StreamManager 建構函式提供 adUiElement,這個方法就會成為免人工管理。

參數

clickElement

元素

做為廣告點擊的元素。

值可以是空值。

已淘汰
將 adUiElement 提供給 StreamManager 建構函式。

streamTimeForContentTime

StreamTimeForContentTime(contentTime) 會傳回數字

傳回特定內容時間含廣告的串流時間。傳回直播的指定內容時間。

參數

contentTime

號碼

不含任何廣告的內容時間 (以秒為單位)。

傳回

number 插入廣告後與指定內容時間對應的串流時間。