中斷API元素

TVSDK提供的API元素在實施中斷時相當實用，包括方法、中繼資料和通知。

在播放器中實作中斷解決方案時，您可以使用下列專案。

• PTMediaPlayer

  • registerCurrentItemAsBackgroundItem 將目前載入的資源儲存為背景資源。 如果 replaceCurrentItemWithPlayerItem 此方法之後呼叫，TVSDK會繼續下載背景專案的資訊清單，直到您呼叫 unregisterCurrentBackgroundItem ， stop，或 reset .

  • unregisterCurrentBackgroundItem 將背景專案設為nil，並停止擷取和分析背景資訊清單。

• PTMetadata.PTBlackoutMetadata A PTMetadata 特定於中斷的類別。

  這可讓您設定無法搜尋的範圍(一個陣列 CMTimeRanges)。 TVSDK會在每次使用者搜尋時檢查這些範圍。 如果設定了TVSDK且使用者搜尋到無法搜尋的範圍，TVSDK會強制檢視器搜尋到無法搜尋範圍的結尾。

• 從這裡開始（下一步） PTAdMetadata 透過設定在即時資料流上啟用或停用前置滾動 enableLivePreroll 設為「是」或「否」。 如果是「否」，TVSDK在內容播放之前不會明確呼叫前段廣告，因此不會播放前段廣告。 這對中間卷沒有影響。 預設值為YES。

• NSNotifications

  • PTTimedMetadataChangedInBackgroundNotification — 當TVSDK偵測到背景資訊清單中的訂閱標籤和新的 PTTimedMetadata 執行個體已從中準備。 通知的物件為 PTMediaPlayerItem 目前正在播放的執行個體。 您可以擷取 PTTimedMetadata 通知的執行個體 userInfo 字典使用 PTTimedMetadataKey 機碼。

  • PTBackgroundManifestErrorNotification — 當媒體播放器完全無法載入背景資訊清單時發佈，也就是說，所有串流URL都會傳回錯誤或無效的回應。 通知的物件為 PTMediaPlayerItem 目前正在播放的執行個體。

• PTNotification

  • BACKGROUND_MANIFEST_WARNING

    • 代碼： 204000
    • 型別：警告
    • 背景資訊清單下載發生錯誤。

  • INVALID_SEEK_WARNING 在無法搜尋的範圍內嘗試搜尋時傳送(在 nonSeekableRanges 設定於 PTBlackoutMetadata)。