當TVSDK偵測到播放清單/資訊清單中的訂閱標籤時,播放器會自動嘗試處理標籤並以PTTimedMetadata物件的形式公開標籤。
該類提供以下元素:
屬性 | 類型 | 說明 |
---|---|---|
metadataId | NSString | 計時中繼資料的唯一識別碼。 此值通常從cue/tag ID屬性中擷取。 否則,提供唯一隨機值。 |
名稱 | NSString | 計時中繼資料的名稱。 如果類型為 TAG,則值代表提示/標籤名稱。 如果類型為 ID3,則為null。 |
時間 | CMTime | 相對於主要內容開始的時間位置(以毫秒為單位),在主要內容開始時,此計時中繼資料會出現在串流中。 |
type | PTTimedMetadataType | 計時中繼資料的類型。
|
請記住:
TVSDK會自動將屬性清單擷取為索引鍵值配對,並將屬性儲存在中繼資料屬性中。
資訊清單中自訂標籤中的複雜資料(例如含特殊字元的字串)必須使用引號。 例如:
#EXT-CUSTOM-TAG:type=SpliceOut,ID=1,time=71819.7222,duration=30.0,url=
"www.example.com:8090?parameter1=xyz¶meter2=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標籤名稱。 |