|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
public interface MetaDataControl
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.
Predefined keys are provided to refer to commonly used metadata fields (title, copyright, data, author).
| Field Summary | ||
|---|---|---|
static String |
AUTHOR_KEY
Default key for AUTHOR information. |
|
static String |
COPYRIGHT_KEY
Default key for COPYRIGHT information. |
|
static String |
DATE_KEY
Default key for DATE information. |
|
static String |
TITLE_KEY
Default key for TITLE information. |
|
| Method Summary | ||
|---|---|---|
String |
getKeyValue(String key)
Retrieve the value found int the metadata associated with the given key. |
|
String[] |
getKeys()
Return the list of keys for the available metadata values. |
|
| Field Detail |
|---|
static final String AUTHOR_KEY
Value "author" is assigned to AUTHOR_KEY.
static final String COPYRIGHT_KEY
Value "copyright" is assigned to COPYRIGHT_KEY.
static final String DATE_KEY
Value "data" is assinged to DATE_KEY.
static final String TITLE_KEY
Value "title" is assigned to TITLE_KEY.
| Method Detail |
|---|
String[] getKeys()
String getKeyValue(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 ahppens, 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.
IllegalArugmentException - Thrown if the given key is
null or invalid.
|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
Copyright 1999-2010 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. All Rights Reserved.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark of Sun Microsystems, Inc.