com.google.android.exoplayer2.mediacodec

Class MediaCodecInfo

java.lang.Object

com.google.android.exoplayer2.mediacodec.MediaCodecInfo

public final class MediaCodecInfo
extends java.lang.Object

Information about a MediaCodec for a given mime type.

Field Summary

Fields

Modifier and Type	Field and Description
boolean	adaptive Whether the decoder supports seamless resolution switches.
java.lang.String	name The name of the decoder.
boolean	secure Whether the decoder is secure.
static java.lang.String	TAG
boolean	tunneling Whether the decoder supports tunneling.

Method Summary

Modifier and Type	Method and Description
android.graphics.Point	alignVideoSizeV21(int width, int height) Returns the smallest video size greater than or equal to a specified size that also satisfies the MediaCodec's width and height alignment requirements.
android.media.MediaCodecInfo.CodecProfileLevel[]	getProfileLevels() The profile levels supported by the decoder.
boolean	isAudioChannelCountSupportedV21(int channelCount) Whether the decoder supports audio with a given channel count.
boolean	isAudioSampleRateSupportedV21(int sampleRate) Whether the decoder supports audio with a given sample rate.
boolean	isCodecSupported(java.lang.String codec) Whether the decoder supports the given codec.
boolean	isVideoSizeAndRateSupportedV21(int width, int height, double frameRate) Whether the decoder supports video with a given width, height and frame rate.
static MediaCodecInfo	newInstance(java.lang.String name, java.lang.String mimeType, android.media.MediaCodecInfo.CodecCapabilities capabilities) Creates an instance.
static MediaCodecInfo	newInstance(java.lang.String name, java.lang.String mimeType, android.media.MediaCodecInfo.CodecCapabilities capabilities, boolean forceDisableAdaptive, boolean forceSecure) Creates an instance.
static MediaCodecInfo	newPassthroughInstance(java.lang.String name) Creates an instance representing an audio passthrough decoder.

Methods inherited from class java.lang.Object

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

Field Detail

TAG

public static final java.lang.String TAG

See Also:

Constant Field Values

name

public final java.lang.String name

The name of the decoder.

May be passed to MediaCodec.createByCodecName(String) to create an instance of the decoder.

adaptive

public final boolean adaptive

Whether the decoder supports seamless resolution switches.

See Also:

MediaCodecInfo.CodecCapabilities.isFeatureSupported(String), MediaCodecInfo.CodecCapabilities.FEATURE_AdaptivePlayback

tunneling

public final boolean tunneling

Whether the decoder supports tunneling.

See Also:

MediaCodecInfo.CodecCapabilities.isFeatureSupported(String), MediaCodecInfo.CodecCapabilities.FEATURE_TunneledPlayback

secure

public final boolean secure

Whether the decoder is secure.

See Also:

MediaCodecInfo.CodecCapabilities.isFeatureSupported(String), MediaCodecInfo.CodecCapabilities.FEATURE_SecurePlayback

Method Detail

newPassthroughInstance

public static MediaCodecInfo newPassthroughInstance(java.lang.String name)

Creates an instance representing an audio passthrough decoder.

Parameters:

name - The name of the MediaCodec.

Returns:

The created instance.

newInstance

public static MediaCodecInfo newInstance(java.lang.String name,
                                         java.lang.String mimeType,
                                         android.media.MediaCodecInfo.CodecCapabilities capabilities)

Creates an instance.

Parameters:

name - The name of the MediaCodec.

mimeType - A mime type supported by the MediaCodec.

capabilities - The capabilities of the MediaCodec for the specified mime type.

Returns:

The created instance.

newInstance

public static MediaCodecInfo newInstance(java.lang.String name,
                                         java.lang.String mimeType,
                                         android.media.MediaCodecInfo.CodecCapabilities capabilities,
                                         boolean forceDisableAdaptive,
                                         boolean forceSecure)

Creates an instance.

Parameters:

name - The name of the MediaCodec.

mimeType - A mime type supported by the MediaCodec.

capabilities - The capabilities of the MediaCodec for the specified mime type.

forceDisableAdaptive - Whether adaptive should be forced to false.

forceSecure - Whether secure should be forced to true.

Returns:

The created instance.

getProfileLevels

public android.media.MediaCodecInfo.CodecProfileLevel[] getProfileLevels()

The profile levels supported by the decoder.

Returns:

The profile levels supported by the decoder.

isCodecSupported

public boolean isCodecSupported(java.lang.String codec)

Whether the decoder supports the given codec. If there is insufficient information to decide, returns true.

Parameters:

codec - Codec string as defined in RFC 6381.

Returns:

True if the given codec is supported by the decoder.

isVideoSizeAndRateSupportedV21

public boolean isVideoSizeAndRateSupportedV21(int width,
                                              int height,
                                              double frameRate)

Whether the decoder supports video with a given width, height and frame rate.

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

Parameters:

width - Width in pixels.

height - Height in pixels.

frameRate - Optional frame rate in frames per second. Ignored if set to Format.NO_VALUE or any value less than or equal to 0.

Returns:

Whether the decoder supports video with the given width, height and frame rate.

alignVideoSizeV21

public android.graphics.Point alignVideoSizeV21(int width,
                                                int height)

Returns the smallest video size greater than or equal to a specified size that also satisfies the MediaCodec's width and height alignment requirements.

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

Parameters:

width - Width in pixels.

height - Height in pixels.

Returns:

The smallest video size greater than or equal to the specified size that also satisfies the MediaCodec's width and height alignment requirements, or null if not a video codec.

isAudioSampleRateSupportedV21

public boolean isAudioSampleRateSupportedV21(int sampleRate)

Whether the decoder supports audio with a given sample rate.

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

Parameters:

sampleRate - The sample rate in Hz.

Returns:

Whether the decoder supports audio with the given sample rate.

isAudioChannelCountSupportedV21

public boolean isAudioChannelCountSupportedV21(int channelCount)

Whether the decoder supports audio with a given channel count.

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

Parameters:

channelCount - The channel count.

Returns:

Whether the decoder supports audio with the given channel count.