MediaCodecInfo

public static final int MAX_SUPPORTED_INSTANCES_UNKNOWN = -1

The value returned by getMaxSupportedInstances if the upper bound on the maximum number of supported instances is unknown.

public static final String TAG = "MediaCodecInfo"

public final boolean adaptive

Whether the decoder supports seamless resolution switches.

public final @Nullable MediaCodecInfo.CodecCapabilities capabilities

The capabilities of the decoder, like the profiles/levels it supports, or null if not known.

public final String codecMimeType

The MIME type that the codec uses for media of type mimeType. Equal to mimeType unless the codec is known to use a non-standard MIME type alias.

public final boolean hardwareAccelerated

Whether the codec is hardware accelerated.

This could be an approximation as the exact information is only provided in API levels 29+.

public final String mimeType

The MIME type handled by the codec.

public final String name

The name of the decoder.

May be passed to createByCodecName to create an instance of the decoder.

public final boolean secure

Whether the decoder is secure.

public final boolean softwareOnly

Whether the codec is software only.

This could be an approximation as the exact information is only provided in API levels 29+.

public final boolean tunneling

Whether the decoder supports tunneling.

public final boolean vendor

Whether the codec is from the vendor.

This could be an approximation as the exact information is only provided in API levels 29+.

@RequiresApi(value = 21)
public @Nullable 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.

public DecoderReuseEvaluation canReuseCodec(Format oldFormat, Format newFormat)

Evaluates whether it's possible to reuse an instance of this decoder that's currently decoding oldFormat to decode newFormat instead.

For adaptation to succeed, the codec must also be configured with maximum values that are compatible with the new format.

public int getMaxSupportedInstances()

Returns an upper bound on the maximum number of supported instances, or MAX_SUPPORTED_INSTANCES_UNKNOWN if unknown. Applications should not expect to operate more instances than the returned maximum.

public MediaCodecInfo.CodecProfileLevel[] getProfileLevels()

The profile levels supported by the decoder.

@RequiresApi(value = 21)
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.

@RequiresApi(value = 21)
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.

public boolean isFormatFunctionallySupported(Format format)

Returns whether the decoder may functionally support decoding the given format.

public boolean isFormatSupported(Format format)

Returns whether the decoder may support decoding the given format both functionally and performantly.

public boolean isHdr10PlusOutOfBandMetadataSupported()

Whether the codec handles HDR10+ out-of-band metadata.

public boolean isSeamlessAdaptationSupported(Format format)

Returns whether it may be possible to adapt an instance of this decoder to playing a different format when the codec is configured to play media in the specified format.

For adaptation to succeed, the codec must also be configured with appropriate maximum values and isSeamlessAdaptationSupported must return true for the old/new formats.

public boolean isSeamlessAdaptationSupported(
    Format oldFormat,
    Format newFormat,
    boolean isNewFormatComplete
)

Returns whether it is possible to adapt an instance of this decoder seamlessly from oldFormat to newFormat. If newFormat may not be completely populated, pass false for isNewFormatComplete.

For adaptation to succeed, the codec must also be configured with maximum values that are compatible with the new format.

@RequiresApi(value = 21)
public boolean isVideoSizeAndRateSupportedV21(int width, int height, double frameRate)

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

public static MediaCodecInfo newInstance(
    String name,
    String mimeType,
    String codecMimeType,
    @Nullable MediaCodecInfo.CodecCapabilities capabilities,
    boolean hardwareAccelerated,
    boolean softwareOnly,
    boolean vendor,
    boolean forceDisableAdaptive,
    boolean forceSecure
)

Creates an instance.

public String toString()