When TVSDK detects a subscribed tag in the playlist/manifest, the player automatically tries to process the tag and expose it in the form of a TimedMetadata object.
The class provides the following elements:
|id||long||Unique identifier of the timed metadata. This value is usually extracted from the cue/tag ID attribute. Otherwise, a unique random value is provided. Use getId .|
|metadata||Metadata||The processed/extracted information from the playlist/manifest custom tag. Use getMetadata .|
|name||String||The name of the timed metadata. If the type is TAG , the value represents the cue/tag name. If the type is ID3 , it is null. Use getName .|
|time||long||The time position, in milliseconds, relative to the start of the main content where this timed metadata is present in the stream. Use getTime .|
|type||Type|| The type of the timed metadata. Use getType .
Remember the following:
TVSDK automatically extracts the attributes list into key-value pairs and stores the attributes in the metadata property.
Complex data in custom tags in the manifest, such as strings with special characters, must be in quotes. For example:
If the extraction fails because of a custom tag format, the metadata property will be empty and your application must extract the actual information. No error is thrown in this case.
||Possible types for the timed metadata.|
||Default constructor (time is the local stream time).|
||The time position, relative to the start of the main content, where this metadata was inserted in the stream.|
||The metadata inserted in the stream.|
||Returns the type of the timed metadata.|
||Returns the ID extracted from the cue/tag attributes. Otherwise, a unique random value is provided.|
||Returns the name of the cue, which is usually the HLS tag name.|