當TVSDK偵測到播放清單/資訊清單中的訂閱標籤時,播放器會自動嘗試以TimedMetadata物件的形式處理和公開標籤。
該類提供以下元素:
屬性 | 類型 | 說明 |
---|---|---|
id | long | 計時中繼資料的唯一識別碼。 此值通常從cue/tag ID屬性中擷取。 否則,提供唯一隨機值。 使用 getId 。 |
中繼資料 | 中繼資料 | 從播放清單/資訊清單自訂標籤中處理/擷取的資訊。 使用 getMetadata 。 |
名稱 | 字串 | 計時中繼資料的名稱。 如果類型為 TAG ,則值代表提示/標籤名稱。 如果類型為 ID3 ,則為null。 使用 getName 。 |
時間 | long | 相對於主要內容開始的時間位置(以毫秒為單位),在主要內容開始時,此計時中繼資料會出現在串流中。 使用 getTime 。 |
type | 類型 | 計時中繼資料的類型。 使用 getType 。
|
請記住:
TVSDK會自動將屬性清單擷取為索引鍵值配對,並將屬性儲存在中繼資料屬性中。
資訊清單中自訂標籤中的複雜資料(例如含特殊字元的字串)必須使用引號。 例如:
#EXT-CUSTOM-TAG:type=SpliceOut,ID=1,time=71819.7222,duration=30.0,url=
"www.example.com:8090?parameter1=xyz¶meter2=abc"
如果擷取因自訂標籤格式而失敗,中繼資料屬性將為空白,而您的應用程式必須擷取實際資訊。 在這種情況下,不會擲回任何錯誤。
元素 | 說明 |
---|---|
public enum類型{TAG, ID3} | 計時中繼資料的可能類型。 |
public TimedMetadata(Type, long time, long id, String name, Metadata); | 預設建構函式(時間是本機串流時間)。 |
public long getTime(); | 相對於主要內容開始的時間位置,此元資料插入到流中。 |
public Metadata getMetadata(); | 插入在串流中的中繼資料。 |
public Type getType(); | 傳回計時中繼資料的類型。 |
public long getId(); | 傳回從提示/標籤屬性擷取的ID。 否則,提供唯一隨機值。 |
public String getName(); | 傳回提示的名稱,此名稱通常為HLS標籤名稱。 |