public interface MetaDataControl extends Control
MetaDataControl
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.
Modifier and Type | Field and Description |
---|---|
static java.lang.String |
AUTHOR_KEY
Default key for AUTHOR information.
|
static java.lang.String |
COPYRIGHT_KEY
Default key for COPYRIGHT information.
|
static java.lang.String |
DATE_KEY
Default key for DATE information.
|
static java.lang.String |
TITLE_KEY
Default key for TITLE information.
|
Modifier and Type | Method and Description |
---|---|
java.lang.String[] |
getKeys()
Return the list of keys for the available metadata values.
|
java.lang.String |
getKeyValue(java.lang.String key)
Retrieve the value found in the metadata associated with the
given key.
|
static final java.lang.String AUTHOR_KEY
Value "author" is assigned to AUTHOR_KEY
.
static final java.lang.String COPYRIGHT_KEY
Value "copyright" is assigned to COPYRIGHT_KEY
.
static final java.lang.String DATE_KEY
Value "date" is assigned to DATE_KEY
.
static final java.lang.String TITLE_KEY
Value "title" is assigned to TITLE_KEY
.
java.lang.String[] getKeys()
java.lang.String getKeyValue(java.lang.String key)
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.
key
- a key to retrieve the value.java.lang.IllegalArgumentException
- Thrown if the given key is
null
or invalid.Copyright © 2013, Oracle and/or its affiliates. All rights reserved.
Use is subject to License Terms. Your use of this web site or any of its contents or software indicates your agreement to be bound by these License Terms.