程序包 ohos.media.codec

类 CodecDescription

java.lang.Object

ohos.media.codec.CodecDescription

public final class CodecDescription
extends Object

Provides methods for obtaining audio and video codec capabilities supported by the current device.

从以下版本开始:

3

另请参阅:

CodecDescriptionList.getSupportedCodecs()

SystemCapability

SystemCapability.Multimedia#MEDIA

方法概要

限定符和类型	方法	说明
String[]	getMimeTypes()	Obtains the MIME types supported by this Codec.
String	getName()	Obtains the name of this Codec object.
<T> T	getPropertyValue(Format.Key<T> property)	Gets the value of a specified property.
<T> T	getPropertyValue(Format.Key<T> property, Size size)	Obtains the value of a specified property of this codec based on a specified video size.
Format	getSupportedFormat()	Obtains the formats supported by this Codec.
boolean	isAudio()	Checks whether this Codec is an audios codec.
boolean	isEncoder()	Checks whether this Codec is an encoder.
boolean	isFormatSupported(Format format)	Checks whether this Codec supports a specified format.
boolean	isSoftware()	Checks whether this Codec is a software codec.

从类继承的方法 java.lang.Object

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

方法详细资料

getName

public String getName()

Obtains the name of this Codec object.

You can understand features of a codec through its name. The name can describe whether the codec is software or hardware, which MIME types it supports, and whether it is an encoder or decoder. For example, SoftwareAvcDecoder indicates a software decoder that supports the AVC format.

返回:

Returns the codec name.

从以下版本开始:

4

isEncoder

public boolean isEncoder()

Checks whether this Codec is an encoder.

返回:

Returns true if this Codec is an encoder; returns false otherwise.

从以下版本开始:

4

isAudio

public boolean isAudio()

Checks whether this Codec is an audios codec.

返回:

Returns true if this Codec is an audio codec; returns false otherwise.

从以下版本开始:

4

isSoftware

public boolean isSoftware()

Checks whether this Codec is a software codec.

Hardware codecs are generally provided by codec vendors.

返回:

Returns true if this Codec is a software codec; returns false otherwise.

从以下版本开始:

4

getMimeTypes

public String[] getMimeTypes()

Obtains the MIME types supported by this Codec.

返回:

Returns the supported MIME types, which can be any keys defined in Format.

从以下版本开始:

4

getSupportedFormat

public Format getSupportedFormat()

Obtains the formats supported by this Codec.

This method returns a Format object that contains keys in the media metadata. The keys include ranges of the audio sampling rate and bit rate, or ranges of the video height and width, bit rate, and frame rate.

To obtain values of these keys, you need to use the Format.getObjectValue(java.lang.String) method and convert data types of return values.

Format keys that can be obtained are as follows:

Format.KEY_SAMPLE_RATE_SCOPE,Format.KEY_SAMPLE_RATE_LIST, Format.KEY_BIT_RATE_SCOPE, Format.KEY_FRAME_RATE_SCOPE, Format.KEY_HEIGHT_SCOPE, ohos.media.common.Format#KEY_WIGHT_SCOPE

返回:

Returns the Format object.

从以下版本开始:

4

isFormatSupported

public boolean isFormatSupported(Format format)

Checks whether this Codec supports a specified format.

参数:

format - Indicates a media format, which may contain information such as the audio sampling rate or video height and width.

返回:

Returns true if this Codec supports the format; returns false otherwise.

从以下版本开始:

4

getPropertyValue

public <T> T getPropertyValue(Format.Key<T> property)

Gets the value of a specified property.

类型参数:

T - Indicates the data type of the property.

参数:

property - Indicates properties supported by the media.

返回:

Returns the value of the static property.

抛出:

NullPointerException - Throws this exception if property is null.

从以下版本开始:

3

getPropertyValue

public <T> T getPropertyValue(Format.Key<T> property,
                              Size size)

Obtains the value of a specified property of this codec based on a specified video size.

类型参数:

T - Indicates the data type of the property value.

参数:

property - Indicates the property whose value is to be obtained. Available properties are defined in the Format class.

size - Indicates the video size.

返回:

Returns the property value.

抛出:

NullPointerException - Throws this exception if property is null.

从以下版本开始:

6