MetaDataControlpublic interface MetaDataControl implements javax.microedition.media.ControlMetaDataControl is used to retrieve metadata information
included within the media streams. A MetaDataControl
object recognizes and stores metadata and provides XML-like accessor
methods to retrieve this information.
Predefined keys are provided to refer to commonly used metadata fields
(title, copyright, data, author). |
Fields Summary |
---|
String | AUTHOR_KEYDefault key for AUTHOR information.
Value "author" is assigned to AUTHOR_KEY . | String | COPYRIGHT_KEYDefault key for COPYRIGHT information.
Value "copyright" is assigned to COPYRIGHT_KEY . | String | DATE_KEYDefault key for DATE information.
Value "date" is assigned to DATE_KEY . | String | TITLE_KEYDefault key for TITLE information.
Value "title" is assigned to TITLE_KEY . |
Methods Summary |
---|
public java.lang.String | getKeyValue(java.lang.String key)Retrieve the value found in the metadata associated with the
given key. Only keys obtained from getKeys
are valid and can be used to retrieve metadata values.
If null or an invalid key is used, an
IllegalArgumentException will be thrown.
Some keys are valid but the associated metadata may not
be available before a certain portion of the media is
played. For example, some streaming media types may
contain metadata that's stored at the end of the file.
As a result, the metadata may not be available
until the playback reaches the end of media. When
that happens, calling getKeyValues with
those keys will return null before the
data is available. However, when the playback reaches
the end of media, all metadata values must be
made available.
| public java.lang.String[] | getKeys()Return the list of keys for the available metadata values.
The returned array must be an array with at least one
key.
|
|