com.google.android.exoplayer

Class MediaCodecUtil

java.lang.Object

com.google.android.exoplayer.MediaCodecUtil

public final class MediaCodecUtil
extends 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 DecoderInfo	getDecoderInfo(String mimeType, boolean secure) Get information about the preferred decoder for a given mime type.
static List<DecoderInfo>	getDecoderInfos(String mimeType, boolean secure) Returns all @{link DecoderInfo}s for a given mime type, in the order given by MediaCodecList.
static DecoderInfo	getPassthroughDecoderInfo() Gets information about a decoder suitable for audio passthrough.
static boolean	isH264ProfileSupported(int profile, int level) Deprecated. Prefer getDecoderInfos(String, boolean) for new code.
static boolean	isSizeAndRateSupportedV21(String mimeType, boolean secure, int width, int height, double frameRate) Tests whether the device advertises it can decode video of a given type at a specified width, height, and frame rate.
static boolean	isSizeSupportedV21(String mimeType, boolean secure, int width, int height) Tests whether the device advertises it can decode video of a given type at a specified width and height.
static int	maxH264DecodableFrameSize()
static void	warmCodec(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

warmCodec

public static void warmCodec(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).

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

public static DecoderInfo getPassthroughDecoderInfo()

Gets information about a decoder suitable for audio passthrough.

Returns:

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

getDecoderInfo

public static DecoderInfo getDecoderInfo(String mimeType,
                                         boolean secure)
                                  throws MediaCodecUtil.DecoderQueryException

Get 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 DecoderInfo describing the decoder, or null if no suitable decoder exists.

Throws:

MediaCodecUtil.DecoderQueryException

getDecoderInfos

public static List<DecoderInfo> getDecoderInfos(String mimeType,
                                                boolean secure)
                                         throws MediaCodecUtil.DecoderQueryException

Returns all @{link DecoderInfo}s for a given mime type, in the order given by MediaCodecList.

Parameters:

mimeType - The mime type.

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

Returns:

A list of all @{link DecoderInfo}s for the given mime type. May be empty if no suitable decoders exist.

Throws:

MediaCodecUtil.DecoderQueryException

isSizeSupportedV21

public static boolean isSizeSupportedV21(String mimeType,
                                         boolean secure,
                                         int width,
                                         int height)
                                  throws MediaCodecUtil.DecoderQueryException

Tests whether the device advertises it can decode video of a given type at a specified width and height.

Must not be called if the device SDK version is less than 21.

Parameters:

mimeType - The mime type.

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

width - Width in pixels.

height - Height in pixels.

Returns:

Whether the decoder advertises support of the given size.

Throws:

MediaCodecUtil.DecoderQueryException

isSizeAndRateSupportedV21

public static boolean isSizeAndRateSupportedV21(String mimeType,
                                                boolean secure,
                                                int width,
                                                int height,
                                                double frameRate)
                                         throws MediaCodecUtil.DecoderQueryException

Tests whether the device advertises it can decode video of a given type at a specified width, height, and frame rate.

Must not be called if the device SDK version is less than 21.

Parameters:

mimeType - The mime type.

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

width - Width in pixels.

height - Height in pixels.

frameRate - Frame rate in frames per second.

Returns:

Whether the decoder advertises support of the given size and frame rate.

Throws:

MediaCodecUtil.DecoderQueryException

isH264ProfileSupported

@Deprecated
public static boolean isH264ProfileSupported(int profile,
                                                         int level)
                                                  throws MediaCodecUtil.DecoderQueryException

Deprecated. Prefer getDecoderInfos(String, boolean) for new code.

Parameters:

profile - An AVC profile constant from MediaCodecInfo.CodecProfileLevel.

level - An AVC profile level from MediaCodecInfo.CodecProfileLevel.

Returns:

Whether the specified profile is supported at the specified level.

Throws:

MediaCodecUtil.DecoderQueryException

maxH264DecodableFrameSize

public static int maxH264DecodableFrameSize()
                                     throws MediaCodecUtil.DecoderQueryException

Returns:

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

Throws:

MediaCodecUtil.DecoderQueryException