計時中繼資料類別

當TVSDK偵測到播放清單/資訊清單中的訂閱標籤時,播放器會自動嘗試處理標籤並以PTTimedMetadata物件的形式公開標籤。

該類提供以下元素:

屬性 類型 說明
metadataId NSString 計時中繼資料的唯一識別碼。 此值通常從cue/tag ID屬性中擷取。 否則,提供唯一隨機值。
名稱 NSString 計時中繼資料的名稱。 如果類型為 TAG,則值代表提示/標籤名稱。 如果類型為 ID3,則為null。
時間 CMTime 相對於主要內容開始的時間位置(以毫秒為單位),在主要內容開始時,此計時中繼資料會出現在串流中。
type PTTimedMetadataType 計時中繼資料的類型。
  • TAG —— 指出計時中繼資料是從播放清單/資訊清單中的標籤建立。
  • ID3 —— 表示計時中繼資料是從媒體串流的ID3標籤建立。

請記住:

  • TVSDK會自動將屬性清單擷取為索引鍵值配對,並將屬性儲存在中繼資料屬性中。

    秘訣

    資訊清單中自訂標籤中的複雜資料(例如含特殊字元的字串)必須使用引號。 例如:

    #EXT-CUSTOM-TAG:type=SpliceOut,ID=1,time=71819.7222,duration=30.0,url=
     "www.example.com:8090?parameter1=xyz&parameter2=abc"
     
  • 如果擷取因自訂標籤格式而失敗,內容屬性一律會包含標籤的原始資料,即冒號後的字串。 此情況下不會擲回錯誤。

元素 說明
TAG, ID3 計時中繼資料的可能類型。
@property (nonatomic, assign) CMTime time 相對於主要內容開始的時間位置,此元資料插入到流中。
@property (nonatomic, assign) PTTimedMetadataType type 傳回計時中繼資料的類型。
@property (nonatomic, retain) NSString *metadataId 傳回從提示/標籤屬性擷取的ID。 否則,提供唯一隨機值。
@property (nonatomic, retain) NSString *name 傳回提示的名稱,此名稱通常為HLS標籤名稱。

本頁內容