計時中繼資料類別

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

該類提供以下元素：

屬性 類型 說明
id long

計時中繼資料的唯一識別碼。

此值通常從cue/tag ID屬性中擷取。 否則，提供唯一隨機值。 使用 getId 。

中繼資料 中繼資料

從播放清單／資訊清單自訂標籤中處理／擷取的資訊。 使用 getMetadata 。

名稱 字串

計時中繼資料的名稱。 如果類型為 TAG ，則值代表提示／標籤名稱。 如果類型為 ID3 ，則為null。 使用 getName 。

時間 long

相對於主要內容開始的時間位置（以毫秒為單位），在主要內容開始時，此計時中繼資料會出現在串流中。 使用 getTime 。

type 類型

計時中繼資料的類型。 使用 getType 。

  • 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"

  • 如果擷取因自訂標籤格式而失敗，中繼資料屬性將為空白，而您的應用程式必須擷取實際資訊。 在這種情況下，不會擲回任何錯誤。

元素 說明
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標籤名稱。

本頁內容