com.google.android.exoplayer2.mediacodec

Class MediaCodecUtil

java.lang.Object

com.google.android.exoplayer2.mediacodec.MediaCodecUtil

public final class MediaCodecUtil
extends java.lang.Object

A utility class for querying the available codecs.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MediaCodecUtil.DecoderQueryException Thrown when an error occurs querying the device for its underlying media capabilities.

Method Summary

Modifier and Type	Method and Description
static android.util.Pair<java.lang.Integer,java.lang.Integer>	getCodecProfileAndLevel(java.lang.String codec) Returns profile and level (as defined by MediaCodecInfo.CodecProfileLevel) corresponding to the given codec description string (as defined by RFC 6381).
static MediaCodecInfo	getDecoderInfo(java.lang.String mimeType, boolean secure) Returns information about the preferred decoder for a given mime type.
static java.util.List<MediaCodecInfo>	getDecoderInfos(java.lang.String mimeType, boolean secure) Returns all MediaCodecInfos for the given mime type, in the order given by MediaCodecList.
static MediaCodecInfo	getPassthroughDecoderInfo() Returns information about a decoder suitable for audio passthrough.
static int	maxH264DecodableFrameSize() Returns the maximum frame size supported by the default H264 decoder.
static void	warmDecoderInfoCache(java.lang.String mimeType, boolean secure) Optional call to warm the codec cache for a given mime type.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

warmDecoderInfoCache

public static void warmDecoderInfoCache(java.lang.String mimeType,
                                        boolean secure)

Optional call to warm the codec cache for a given mime type.

Calling this method may speed up subsequent calls to getDecoderInfo(String, boolean) and getDecoderInfos(String, boolean).

Parameters:

mimeType - The mime type.

secure - Whether the decoder is required to support secure decryption. Always pass false unless secure decryption really is required.

getPassthroughDecoderInfo

@Nullable
public static MediaCodecInfo getPassthroughDecoderInfo()
                                                          throws MediaCodecUtil.DecoderQueryException

Returns information about a decoder suitable for audio passthrough.

Returns:

A MediaCodecInfo describing the decoder, or null if no suitable decoder exists.

Throws:

MediaCodecUtil.DecoderQueryException - If there was an error querying the available decoders.

getDecoderInfo

@Nullable
public static MediaCodecInfo getDecoderInfo(java.lang.String mimeType,
                                                      boolean secure)
                                               throws MediaCodecUtil.DecoderQueryException

Returns information about the preferred decoder for a given mime type.

Parameters:

mimeType - The MIME type.

secure - Whether the decoder is required to support secure decryption. Always pass false unless secure decryption really is required.

Returns:

A MediaCodecInfo describing the decoder, or null if no suitable decoder exists.

Throws:

MediaCodecUtil.DecoderQueryException - If there was an error querying the available decoders.

getDecoderInfos

public static java.util.List<MediaCodecInfo> getDecoderInfos(java.lang.String mimeType,
                                                             boolean secure)
                                                      throws MediaCodecUtil.DecoderQueryException

Returns all MediaCodecInfos for the given mime type, in the order given by MediaCodecList.

Parameters:

mimeType - The MIME type.

secure - Whether the decoder is required to support secure decryption. Always pass false unless secure decryption really is required.

Returns:

A list of all MediaCodecInfos for the given mime type, in the order given by MediaCodecList.

Throws:

MediaCodecUtil.DecoderQueryException - If there was an error querying the available decoders.

maxH264DecodableFrameSize

public static int maxH264DecodableFrameSize()
                                     throws MediaCodecUtil.DecoderQueryException

Returns the maximum frame size supported by the default H264 decoder.

Returns:

The maximum frame size for an H264 stream that can be decoded on the device.

Throws:

MediaCodecUtil.DecoderQueryException

getCodecProfileAndLevel

@Nullable
public static android.util.Pair<java.lang.Integer,java.lang.Integer> getCodecProfileAndLevel(java.lang.String codec)

Returns profile and level (as defined by MediaCodecInfo.CodecProfileLevel) corresponding to the given codec description string (as defined by RFC 6381).

Parameters:

codec - A codec description string, as defined by RFC 6381.

Returns:

A pair (profile constant, level constant) if codec is well-formed and recognized, or null otherwise