Classe metadati temporizzati

Quando TVSDK rileva un tag con sottoscrizione nella playlist o nel manifesto, il lettore prova automaticamente a elaborare il tag ed esporlo sotto forma di un oggetto TimedMetadata.

La classe fornisce i seguenti elementi:

Proprietà Tipo Descrizione
id long Identificatore univoco dei metadati temporizzati. Questo valore viene solitamente estratto dall’attributo cue/tag ID . In caso contrario, viene fornito un valore casuale univoco. Utilizza getId .
metadati Metadati Le informazioni elaborate/estratte dal tag personalizzato playlist/manifest. Utilizza getMetadata .
name Stringa Nome dei metadati temporizzati. Se il tipo è TAG , il valore rappresenta il nome del cue/tag. Se il tipo è ID3 , è null. Utilizzare getName .
time long La posizione temporale, in millisecondi, relativa all'inizio del contenuto principale in cui sono presenti i metadati temporizzati nel flusso. Utilizzare getTime .
type Tipo Il tipo di metadati temporizzati. Utilizza getType .
  • TAG - indica che i metadati temporizzati sono stati creati da un tag nella playlist/manifesto.
  • ID3 - indica che i metadati temporizzati sono stati creati da un tag ID3 nel flusso multimediale.

Ricorda quanto segue:

  • TVSDK estrae automaticamente l’elenco degli attributi in coppie chiave-valore e memorizza gli attributi nella proprietà metadati.

    SUGGERIMENTO

    I dati complessi nei tag personalizzati nel manifesto, come le stringhe con caratteri speciali, devono essere racchiusi tra virgolette. Ad esempio:

    #EXT-CUSTOM-TAG:type=SpliceOut,ID=1,time=71819.7222,duration=30.0,
     url="www.example.com:8090?parameter1=xyz&parameter2=abc"
     
  • Se l’estrazione non riesce a causa di un formato di tag personalizzato, la proprietà dei metadati sarà vuota e l’applicazione deve estrarre le informazioni effettive. In questo caso non viene generato alcun errore.

Elemento Descrizione
public enum Type { TAG, ID3} Tipi possibili per i metadati temporizzati.
public TimedMetadata(Type type, long time, long id, String name, Metadata metadata); costruttore predefinito (l'ora è l'ora del flusso locale).
public long getTime(); La posizione temporale relativa all'inizio del contenuto principale, in cui tali metadati sono stati inseriti nel flusso.
public Metadata getMetadata(); I metadati inseriti nel flusso.
public Type getType(); Restituisce il tipo di metadati temporizzati.
public long getId(); Restituisce l’ID estratto dagli attributi cue/tag. In caso contrario, viene fornito un valore casuale univoco.
public String getName(); Restituisce il nome del cue, che in genere corrisponde al nome del tag HLS.

In questa pagina