AVCapability

概述

AVCapability模块提供用于编解码能力查询的函数。

@syscap SystemCapability.Multimedia.Media.CodecBase

起始版本：

10

汇总

文件

结构体

类型定义

枚举

函数

变量

类型定义说明

OH_AVCodecCategory

typedef enum OH_AVCodecCategory OH_AVCodecCategory

描述：

编解码器类别。

@syscap SystemCapability.Multimedia.Media.CodecBase

起始版本：

10

OH_AVRange

typedef struct OH_AVRange OH_AVRange

描述：

范围包含最小值和最大值。

@syscap SystemCapability.Multimedia.Media.CodecBase

起始版本：

10

OH_BitrateMode

typedef enum OH_BitrateMode OH_BitrateMode

描述：

编码器的比特率模式。

@syscap SystemCapability.Multimedia.Media.CodecBase

起始版本：

10

枚举类型说明

OH_AVCodecCategory

enum OH_AVCodecCategory

描述：

编解码器类别。

@syscap SystemCapability.Multimedia.Media.CodecBase

起始版本：

10

OH_BitrateMode

enum OH_BitrateMode

描述：

编码器的比特率模式。

@syscap SystemCapability.Multimedia.Media.CodecBase

起始版本：

10

函数说明

OH_AVCapability_AreProfileAndLevelSupported()

bool OH_AVCapability_AreProfileAndLevelSupported (OH_AVCapability *capability, int32_t profile, int32_t level)

描述：

检查编解码器是否支持配置文件和级别的特定组合。

@syscap SystemCapability.Multimedia.Media.CodecBase

参数：

返回：

如果支持配置文件和级别的组合，则返回true。 如果不支持，则为false。

起始版本：

10

OH_AVCapability_AreVideoSizeAndFrameRateSupported()

bool OH_AVCapability_AreVideoSizeAndFrameRateSupported (OH_AVCapability *capability, int32_t width, int32_t height, int32_t frameRate)

描述：

检查视频编解码器是否支持视频大小和帧率的特定组合。

@syscap SystemCapability.Multimedia.Media.CodecBase

参数：

返回：

如果支持视频大小和帧率的组合，则返回true。 如果不支持，则为false。

起始版本：

10

OH_AVCapability_GetAudioChannelCountRange()

OH_AVErrCode OH_AVCapability_GetAudioChannelCountRange (OH_AVCapability *capability, OH_AVRange *channelCountRange)

描述：

获取音频编解码器支持的音频通道计数范围。

@syscap SystemCapability.Multimedia.Media.CodecBase

参数：

返回：

如果执行成功，则返回AV_ERR_OK， 否则返回特定错误代码，请参阅OH_AVErrCode。

起始版本：

10

OH_AVCapability_GetAudioSupportedSampleRates()

OH_AVErrCode OH_AVCapability_GetAudioSupportedSampleRates (OH_AVCapability *capability, const int32_t **sampleRates, uint32_t *sampleRateNum)

描述：

获取音频编解码器支持的采样速率。

@syscap SystemCapability.Multimedia.Media.CodecBase

参数：

返回：

如果执行成功，则返回AV_ERR_OK， 否则返回特定错误代码，请参阅OH_AVErrCode。

起始版本：

10

OH_AVCapability_GetEncoderBitrateRange()

OH_AVErrCode OH_AVCapability_GetEncoderBitrateRange (OH_AVCapability *capability, OH_AVRange *bitrateRange)

描述：

获取编码器支持的比特率范围。

@syscap SystemCapability.Multimedia.Media.CodecBase

参数：

返回：

如果执行成功，则返回AV_ERR_OK， 否则返回特定错误代码，请参阅OH_AVErrCode。

起始版本：

10

OH_AVCapability_GetEncoderComplexityRange()

OH_AVErrCode OH_AVCapability_GetEncoderComplexityRange (OH_AVCapability *capability, OH_AVRange *complexityRange)

描述：

获取编码器支持的编码器复杂性范围。

@syscap SystemCapability.Multimedia.Media.CodecBase

参数：

返回：

如果执行成功，则返回AV_ERR_OK， 否则返回特定错误代码，请参阅OH_AVErrCode。

起始版本：

10

OH_AVCapability_GetEncoderQualityRange()

OH_AVErrCode OH_AVCapability_GetEncoderQualityRange (OH_AVCapability *capability, OH_AVRange *qualityRange)

描述：

获取编码器支持的质量范围。

@syscap SystemCapability.Multimedia.Media.CodecBase

参数：

返回：

如果执行成功，则返回AV_ERR_OK， 否则返回特定错误代码，请参阅OH_AVErrCode。

起始版本：

10

OH_AVCapability_GetMaxSupportedInstances()

int32_t OH_AVCapability_GetMaxSupportedInstances (OH_AVCapability *capability)

描述：

获取编解码器支持的最大实例数。

@syscap SystemCapability.Multimedia.Media.CodecBase

参数：

返回：

返回支持的最大编解码器实例数。

起始版本：

10

OH_AVCapability_GetName()

const char* OH_AVCapability_GetName (OH_AVCapability *capability)

描述：

获取编解码器名称。

@syscap SystemCapability.Multimedia.Media.CodecBase

参数：

返回：

返回编解码器名称字符串。

起始版本：

10

OH_AVCapability_GetSupportedLevelsForProfile()

OH_AVErrCode OH_AVCapability_GetSupportedLevelsForProfile (OH_AVCapability *capability, int32_t profile, const int32_t **levels, uint32_t *levelNum)

描述：

获取特定配置文件支持的编解码器级别。

@syscap SystemCapability.Multimedia.Media.CodecBase

参数：

返回：

如果执行成功，则返回AV_ERR_OK， 否则返回特定错误代码，请参阅OH_AVErrCode。

起始版本：

10

OH_AVCapability_GetSupportedProfiles()

OH_AVErrCode OH_AVCapability_GetSupportedProfiles (OH_AVCapability *capability, const int32_t **profiles, uint32_t *profileNum)

描述：

获取编解码器支持的配置文件。

@syscap SystemCapability.Multimedia.Media.CodecBase

参数：

返回：

如果执行成功，则返回AV_ERR_OK， 否则返回特定错误代码，请参阅OH_AVErrCode。

起始版本：

10

OH_AVCapability_GetVideoFrameRateRange()

OH_AVErrCode OH_AVCapability_GetVideoFrameRateRange (OH_AVCapability *capability, OH_AVRange *frameRateRange)

描述：

获取视频编解码器支持的视频帧率范围。

@syscap SystemCapability.Multimedia.Media.CodecBase

参数：

返回：

如果执行成功，则返回AV_ERR_OK， 否则返回特定错误代码，请参阅OH_AVErrCode。

起始版本：

10

OH_AVCapability_GetVideoFrameRateRangeForSize()

OH_AVErrCode OH_AVCapability_GetVideoFrameRateRangeForSize (OH_AVCapability *capability, int32_t width, int32_t height, OH_AVRange *frameRateRange)

描述：

获取指定视频大小的视频编解码器支持的视频帧率范围。

@syscap SystemCapability.Multimedia.Media.CodecBase

参数：

返回：

如果执行成功，则返回AV_ERR_OK， 否则返回特定错误代码，请参阅OH_AVErrCode。

起始版本：

10

OH_AVCapability_GetVideoHeightAlignment()

OH_AVErrCode OH_AVCapability_GetVideoHeightAlignment (OH_AVCapability *capability, int32_t *heightAlignment)

描述：

获取视频编解码器支持的视频高度对齐。

@syscap SystemCapability.Multimedia.Media.CodecBase

参数：

返回：

如果执行成功，则返回AV_ERR_OK， 否则返回特定错误代码，请参阅OH_AVErrCode。

起始版本：

10

OH_AVCapability_GetVideoHeightRange()

OH_AVErrCode OH_AVCapability_GetVideoHeightRange (OH_AVCapability *capability, OH_AVRange *heightRange)

描述：

获取视频编解码器支持的视频高度范围。

@syscap SystemCapability.Multimedia.Media.CodecBase

参数：

返回：

如果执行成功，则返回AV_ERR_OK， 否则返回特定错误代码，请参阅OH_AVErrCode。

起始版本：

10

OH_AVCapability_GetVideoHeightRangeForWidth()

OH_AVErrCode OH_AVCapability_GetVideoHeightRangeForWidth (OH_AVCapability *capability, int32_t width, OH_AVRange *heightRange)

描述：

获取指定宽度情况下视频编解码器支持的视频高度范围。

@syscap SystemCapability.Multimedia.Media.CodecBase

参数：

返回：

如果执行成功，则返回AV_ERR_OK， 否则返回特定错误代码，请参阅OH_AVErrCode。

起始版本：

10

OH_AVCapability_GetVideoSupportedPixelFormats()

OH_AVErrCode OH_AVCapability_GetVideoSupportedPixelFormats (OH_AVCapability *capability, const int32_t **pixelFormats, uint32_t *pixelFormatNum)

描述：

获取视频编解码器支持的视频像素格式。

@syscap SystemCapability.Multimedia.Media.CodecBase

参数：

返回：

如果执行成功，则返回AV_ERR_OK， 否则返回特定错误代码，请参阅OH_AVErrCode。

起始版本：

10

OH_AVCapability_GetVideoWidthAlignment()

OH_AVErrCode OH_AVCapability_GetVideoWidthAlignment (OH_AVCapability *capability, int32_t *widthAlignment)

描述：

获取视频编解码器支持的视频宽度对齐。

@syscap SystemCapability.Multimedia.Media.CodecBase

参数：

返回：

如果执行成功，则返回AV_ERR_OK， 否则返回特定错误代码，请参阅OH_AVErrCode。

起始版本：

10

OH_AVCapability_GetVideoWidthRange()

OH_AVErrCode OH_AVCapability_GetVideoWidthRange (OH_AVCapability *capability, OH_AVRange *widthRange)

描述：

获取视频编解码器支持的视频宽度范围。

@syscap SystemCapability.Multimedia.Media.CodecBase

参数：

返回：

如果执行成功，则返回AV_ERR_OK， 否则返回特定错误代码，请参阅OH_AVErrCode。

起始版本：

10

OH_AVCapability_GetVideoWidthRangeForHeight()

OH_AVErrCode OH_AVCapability_GetVideoWidthRangeForHeight (OH_AVCapability *capability, int32_t height, OH_AVRange *widthRange)

描述：

获取指定高度情况下视频编解码器支持的视频宽度范围。

@syscap SystemCapability.Multimedia.Media.CodecBase

参数：

返回：

如果执行成功，则返回AV_ERR_OK， 否则返回特定错误代码，请参阅OH_AVErrCode。

起始版本：

10

OH_AVCapability_IsEncoderBitrateModeSupported()

bool OH_AVCapability_IsEncoderBitrateModeSupported (OH_AVCapability *capability, OH_BitrateMode bitrateMode)

描述：

检查编码器是否支持特定的比特率模式。

@syscap SystemCapability.Multimedia.Media.CodecBase

参数：

返回：

如果支持该比特率模式，则返回true；如果不支持该比特率模式，则返回false。

起始版本：

10

OH_AVCapability_IsHardware()

bool OH_AVCapability_IsHardware (OH_AVCapability *capability)

描述：

检查能力实例是否描述了硬件编解码器。

@syscap SystemCapability.Multimedia.Media.CodecBase

参数：

返回：

如果能力实例描述的是硬件编解码器，则返回true， 如果功能实例描述的是软件编解码器，则为false。

起始版本：

10

OH_AVCapability_IsVideoSizeSupported()

bool OH_AVCapability_IsVideoSizeSupported (OH_AVCapability *capability, int32_t width, int32_t height)

描述：

检查视频编解码器是否支持特定的视频大小。

@syscap SystemCapability.Multimedia.Media.CodecBase

参数：

返回：

如果支持该视频大小，则返回true，如果不支持该视频大小，则返回false。

起始版本：

10

OH_AVCodec_GetCapability()

OH_AVCapability* OH_AVCodec_GetCapability (const char *mime, bool isEncoder)

描述：

获取系统推荐的编解码器能力。

@syscap SystemCapability.Multimedia.Media.CodecBase

参数：

返回：

如果现有编解码器匹配，则返回能力实例， 如果指定的MIME类型与任何现有编解码器不匹配，则返回NULL。

起始版本：

10

OH_AVCodec_GetCapabilityByCategory()

OH_AVCapability* OH_AVCodec_GetCapabilityByCategory (const char *mime, bool isEncoder, OH_AVCodecCategory category)

描述：

获取指定类别中的编解码器能力。

通过指定类别， 匹配的编解码器仅限于硬件编解码器或软件编解码器。

@syscap SystemCapability.Multimedia.Media.CodecBase

参数：

返回：

如果现有编解码器匹配，则返回能力实例， 如果指定的MIME类型与任何现有编解码器不匹配，则返回NULL。

起始版本：

10