Developers
Most visited
Recently visited
MediaCodecList
public
final
class
MediaCodecList
extends Object
| java.lang.Object | |
| ↳ | android.media.MediaCodecList |
Allows you to enumerate available codecs, each specified as a MediaCodecInfo object,
find a codec supporting a given format and query the capabilities
of a given codec.
See MediaCodecInfo for sample usage.
Summary
Constants | |
|---|---|
int |
ALL_CODECS
Use in |
int |
REGULAR_CODECS
Use in |
Public constructors | |
|---|---|
MediaCodecList(int kind)
Create a list of media-codecs of a specific kind. |
|
Public methods | |
|---|---|
String
|
findDecoderForFormat(MediaFormat format)
Find a decoder supporting a given |
String
|
findEncoderForFormat(MediaFormat format)
Find an encoder supporting a given |
static
int
|
getCodecCount()
This method is deprecated.
Use |
static
MediaCodecInfo
|
getCodecInfoAt(int index)
This method is deprecated.
Use |
MediaCodecInfo[]
|
getCodecInfos()
Returns the list of |
Inherited methods | |
|---|---|
Constants
ALL_CODECS
public static final int ALL_CODECS
Use in MediaCodecList(int) to enumerate all codecs, even ones that are
not suitable for regular (buffer-to-buffer) decoding or encoding. These
include codecs, for example, that only work with special input or output
surfaces, such as secure-only or tunneled-only codecs.
See also:
Constant Value: 1 (0x00000001)
REGULAR_CODECS
public static final int REGULAR_CODECS
Use in MediaCodecList(int) to enumerate only codecs that are suitable
for regular (buffer-to-buffer) decoding or encoding.
NOTE: These are the codecs that are returned prior to API 21,
using the now deprecated static methods.
Constant Value: 0 (0x00000000)
Public constructors
MediaCodecList
public MediaCodecList (int kind)
Create a list of media-codecs of a specific kind.
| Parameters | |
|---|---|
kind |
int: Either REGULAR_CODECS or ALL_CODECS. |
Public methods
findDecoderForFormat
public String findDecoderForFormat (MediaFormat format)
Find a decoder supporting a given MediaFormat in the list
of media-codecs.
Note: On Build.VERSION_CODES.LOLLIPOP,
format must not contain a MediaFormat#KEY_FRAME_RATE. Use
format.setString(MediaFormat.KEY_FRAME_RATE, null)
to clear any existing frame rate setting in the format.
| Parameters | |
|---|---|
format |
MediaFormat: A decoder media format with optional feature directives. |
| Returns | |
|---|---|
String |
the name of a decoder that supports the given format and feature
requests, or null if no such codec has been found. |
| Throws | |
|---|---|
IllegalArgumentException |
if format is not a valid media format. |
NullPointerException |
if format is null. |
findEncoderForFormat
public String findEncoderForFormat (MediaFormat format)
Find an encoder supporting a given MediaFormat in the list
of media-codecs.
Note: On Build.VERSION_CODES.LOLLIPOP,
format must not contain a MediaFormat#KEY_FRAME_RATE. Use
format.setString(MediaFormat.KEY_FRAME_RATE, null)
to clear any existing frame rate setting in the format.
| Parameters | |
|---|---|
format |
MediaFormat: An encoder media format with optional feature directives. |
| Returns | |
|---|---|
String |
the name of an encoder that supports the given format and feature
requests, or null if no such codec has been found. |
| Throws | |
|---|---|
IllegalArgumentException |
if format is not a valid media format. |
NullPointerException |
if format is null. |
getCodecCount
public static int getCodecCount ()
This method is deprecated.
Use getCodecInfos() instead.
Count the number of available (regular) codecs.
| Returns | |
|---|---|
int |
|
See also:
getCodecInfoAt
public static MediaCodecInfo getCodecInfoAt (int index)
This method is deprecated.
Use getCodecInfos() instead.
Return the MediaCodecInfo object for the codec at
the given index in the regular list.
| Parameters | |
|---|---|
index |
int |
| Returns | |
|---|---|
MediaCodecInfo |
|
See also:
getCodecInfos
public MediaCodecInfo[] getCodecInfos ()
Returns the list of MediaCodecInfo objects for the list
of media-codecs.
| Returns | |
|---|---|
MediaCodecInfo[] |
|