封鎖API元素

TVSDK提供在實作封鎖期(包括方法、中繼資料和通知)時有用的API元素。

在您的播放器中實施封鎖期解決方案時,可使用下列功能。

  • PTMediaPlayer

    • registerCurrentItemAsBackgroundItem 將當前載入的資源另存為背景資源。如果在此方法後呼叫replaceCurrentItemWithPlayerItem,TVSDK會繼續下載背景項目的資訊清單,直到您呼叫unregisterCurrentBackgroundItemstopreset為止。

    • unregisterCurrentBackgroundItem 將背景項目設為nil,並停止擷取和剖析背景資訊清單。

  • PTMetadata. PTBlackoutMetadataA類, PTMetadata 專用於封鎖期。

    這可讓您在TVSDK上設定不可見的範圍(CMTimeRanges的陣列)。 TVSDK會在使用者每次搜尋時檢查這些範圍。 如果已設定,且使用者搜尋至不可見的範圍,TVSDK會強制檢視器到達不可見的範圍結尾。

  • 從這裡開 ​始NEXTPTAdMetadata透過設定為YES或NO,啟用或停用即時串 enableLivePreroll 流上的前置播放。若為否,TVSDK在內容播放前不會明確呼叫前段廣告廣告伺服器,因此不會播放前段廣告。 這對中間輥沒有影響。 預設值為YES。

  • NSNoftigies

    • PTTimedMetadataChangedInBackgroundNotification -當TVSDK偵測到背景資訊清單中的訂閱標籤,並準備新 PTTimedMetadata 的例項時發佈。通知的對象是當前正在播放的PTMediaPlayerItem實例。 您可以使用PTTimedMetadataKey鍵從通知的userInfo字典中讀取PTTimedMetadata實例。

    • PTBackgroundManifestErrorNotification -當媒體播放器完全無法載入背景資訊清單時發佈,即所有串流URL都會傳回錯誤或無效回應。通知的對象是當前正在播放的PTMediaPlayerItem實例。

  • PTNotification

    • BACKGROUND_MANIFEST_WARNING

      • 程式碼:204000
      • 類型:警告
      • 背景資訊清單下載時發生錯誤。
    • INVALID_SEEK_WARNING 在不可查找範圍(在中設定)中嘗試查找時 nonSeekableRanges 發送 PTBlackoutMetadata的。

本頁內容