當TVSDK在播放清單/清單中檢測到預訂的標籤時,播放器自動嘗試以TimedMetadata對象的形式處理和公開該標籤。
類提供以下元素:
屬性 | 類型 | 說明 |
---|---|---|
ID | 長 | 定時元資料的唯一標識符。 此值通常從提示/標籤ID屬性中提取。 否則,提供唯一隨機值。 使用 getId 。 |
元資料 | 元資料 | 從播放清單/清單自定義標籤中處理/提取的資訊。 使用 getMetadata 。 |
名稱 | 字串 | 定時元資料的名稱。 如果類型為 標籤 ,值表示提示/標籤名稱。 如果類型為 ID3 ,它為空。 使用 getName 。 |
時間 | 長 | 相對於主內容開始的時間位置(毫秒),其中流中存在此定時元資料。 使用 getTime 。 |
類型 | 類型 | 定時元資料的類型。 使用 getType 。
|
請記住以下內容:
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} | 定時元資料的可能類型。 |
public TimedMetadata(類型、長時間、長ID、字串名、元資料); | 預設建構子(時間是本地流時間)。 |
public long getTime(); | 相對於主內容開始的時間位置,在該位置將元資料插入流中。 |
公共元資料getMetadata(); | 在流中插入的元資料。 |
public Type getType(); | 返回定時元資料的類型。 |
public long getId(); | 返回從提示/標籤屬性提取的ID。 否則,提供唯一隨機值。 |
公共字串getName(); | 返回提示的名稱,通常是HLS標籤名稱。 |