harmony 鸿蒙AVCapability

  • 2023-06-24
  • 浏览 (460)

AVCapability

概述

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

\@syscap SystemCapability.Multimedia.Media.CodecBase

起始版本：

10

汇总

文件

名称 描述
native_avcapability.h 声明用于编解码能力查询到的Native API。
引用文件：
库：libnative_media_codecbase.so

结构体

名称 描述
OH_AVRange 范围包含最小值和最大值。

类型定义

名称 描述
OH_BitrateMode 编码器的比特率模式。
OH_AVRange 范围包含最小值和最大值。
OH_AVCodecCategory 编解码器类别。

枚举

名称 描述
OH_BitrateMode { BITRATE_MODE_CBR = 0, BITRATE_MODE_VBR = 1, BITRATE_MODE_CQ = 2 } 编码器的比特率模式。
OH_AVCodecCategory { HARDWARE = 0, SOFTWARE } 编解码器类别。

函数

名称 描述
*OH_AVCodec_GetCapability (const char *mime, bool isEncoder) 获取系统推荐的编解码器能力。
*OH_AVCodec_GetCapabilityByCategory (const char *mime, bool isEncoder, OH_AVCodecCategory category) 获取指定类别中的编解码器能力。通过指定类别， 匹配的编解码器仅限于硬件编解码器或软件编解码器。
OH_AVCapability_IsHardware (OH_AVCapability *capability) 检查能力实例是否描述了硬件编解码器。
*OH_AVCapability_GetName (OH_AVCapability *capability) 获取编解码器名称。
OH_AVCapability_GetMaxSupportedInstances (OH_AVCapability *capability) 获取编解码器支持的最大实例数。
OH_AVCapability_GetEncoderBitrateRange (OH_AVCapability *capability, OH_AVRange *bitrateRange) 获取编码器支持的比特率范围。
OH_AVCapability_IsEncoderBitrateModeSupported (OH_AVCapability *capability, OH_BitrateMode bitrateMode) 检查编码器是否支持特定的比特率模式。
OH_AVCapability_GetEncoderQualityRange (OH_AVCapability *capability, OH_AVRange *qualityRange) 获取编码器支持的质量范围。
OH_AVCapability_GetEncoderComplexityRange (OH_AVCapability *capability, OH_AVRange *complexityRange) 获取编码器支持的编码器复杂性范围。
OH_AVCapability_GetAudioSupportedSampleRates (OH_AVCapability *capability, const int32_t **sampleRates, uint32_t *sampleRateNum) 获取音频编解码器支持的采样速率。
OH_AVCapability_GetAudioChannelCountRange (OH_AVCapability *capability, OH_AVRange *channelCountRange) 获取音频编解码器支持的音频通道计数范围。
OH_AVCapability_GetVideoWidthAlignment (OH_AVCapability *capability, int32_t *widthAlignment) 获取视频编解码器支持的视频宽度对齐。
OH_AVCapability_GetVideoHeightAlignment (OH_AVCapability *capability, int32_t *heightAlignment) 获取视频编解码器支持的视频高度对齐。
OH_AVCapability_GetVideoWidthRangeForHeight (OH_AVCapability *capability, int32_t height, OH_AVRange *widthRange) 获取指定高度情况下视频编解码器支持的视频宽度范围。
OH_AVCapability_GetVideoHeightRangeForWidth (OH_AVCapability *capability, int32_t width, OH_AVRange *heightRange) 获取指定宽度情况下视频编解码器支持的视频高度范围。
OH_AVCapability_GetVideoWidthRange (OH_AVCapability *capability, OH_AVRange *widthRange) 获取视频编解码器支持的视频宽度范围。
OH_AVCapability_GetVideoHeightRange (OH_AVCapability *capability, OH_AVRange *heightRange) 获取视频编解码器支持的视频高度范围。
OH_AVCapability_IsVideoSizeSupported (OH_AVCapability *capability, int32_t width, int32_t height) 检查视频编解码器是否支持特定的视频大小。
OH_AVCapability_GetVideoFrameRateRange (OH_AVCapability *capability, OH_AVRange *frameRateRange) 获取视频编解码器支持的视频帧率范围。
OH_AVCapability_GetVideoFrameRateRangeForSize (OH_AVCapability *capability, int32_t width, int32_t height, OH_AVRange *frameRateRange) 获取指定视频大小的视频编解码器支持的视频帧率范围。
OH_AVCapability_AreVideoSizeAndFrameRateSupported (OH_AVCapability *capability, int32_t width, int32_t height, int32_t frameRate) 检查视频编解码器是否支持视频大小和帧率的特定组合。
OH_AVCapability_GetVideoSupportedPixelFormats (OH_AVCapability *capability, const int32_t **pixelFormats, uint32_t *pixelFormatNum) 获取视频编解码器支持的视频像素格式。
OH_AVCapability_GetSupportedProfiles (OH_AVCapability *capability, const int32_t **profiles, uint32_t *profileNum) 获取编解码器支持的配置文件。
OH_AVCapability_GetSupportedLevelsForProfile (OH_AVCapability *capability, int32_t profile, const int32_t **levels, uint32_t *levelNum) 获取特定配置文件支持的编解码器级别。
OH_AVCapability_AreProfileAndLevelSupported (OH_AVCapability *capability, int32_t profile, int32_t level) 检查编解码器是否支持配置文件和级别的特定组合。

变量

名称 描述
OH_AVRange::minVal 范围下限
OH_AVRange::maxVal 范围上限

类型定义说明

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

枚举值 描述
HARDWARE 硬件编解码。
SOFTWARE 软件编解码。

OH_BitrateMode

enum OH_BitrateMode

描述：

编码器的比特率模式。

\@syscap SystemCapability.Multimedia.Media.CodecBase

起始版本：

10

枚举值 描述
BITRATE_MODE_CBR 恒定比特率模式。
BITRATE_MODE_VBR 可变比特率模式。
BITRATE_MODE_CQ 恒定质量模式。

函数说明

OH_AVCapability_AreProfileAndLevelSupported()

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

描述：

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

\@syscap SystemCapability.Multimedia.Media.CodecBase

参数：

名称 描述
capability 编解码能力指针
profile 编解码器配置文件
level 编解码器级别

返回：

如果支持配置文件和级别的组合，则返回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

参数：

名称 描述
capability 视频编解码能力指针。不能填入音频编解码器能力指针。
width 视频水平像素数。
height 视频垂直像素数。
frameRate 每秒帧数。

返回：

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

起始版本：

10

OH_AVCapability_GetAudioChannelCountRange()

OH_AVErrCode OH_AVCapability_GetAudioChannelCountRange (OH_AVCapability *capability, OH_AVRange *channelCountRange)

描述：

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

\@syscap SystemCapability.Multimedia.Media.CodecBase

参数：

名称 描述
capability 音频编解码能力指针。不能填入视频编解码器能力指针。
channelCountRange 输出参数。音频通道计数范围。

返回：

如果执行成功，则返回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

参数：

名称 描述
capability 音频编解码能力指针。不能填入视频编解码器能力指针。
sampleRates 输出参数。指向采样速率数组的指针。
sampleRateNum 输出参数。采样率数组的元素数目。

返回：

如果执行成功，则返回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

参数：

名称 描述
capability 编码器能力指针。不能填入解码器能力指针。
bitrateRange 输出参数。编码器码率范围。

返回：

如果执行成功，则返回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

参数：

名称 描述
capability 编码器能力指针。不能填入解码器能力指针。
complexityRange 输出参数。编码器复杂度范围。

返回：

如果执行成功，则返回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

参数：

名称 描述
capability 编码器能力指针。不能填入解码器能力指针。
qualityRange 输出参数。编码器质量范围。

返回：

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

起始版本：

10

OH_AVCapability_GetMaxSupportedInstances()

int32_t OH_AVCapability_GetMaxSupportedInstances (OH_AVCapability *capability)

描述：

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

\@syscap SystemCapability.Multimedia.Media.CodecBase

参数：

名称 描述
capability 编解码能力指针。

返回：

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

起始版本：

10

OH_AVCapability_GetName()

const char* OH_AVCapability_GetName (OH_AVCapability *capability)

描述：

获取编解码器名称。

\@syscap SystemCapability.Multimedia.Media.CodecBase

参数：

名称 描述
capability 编解码能力指针。

返回：

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

起始版本：

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

参数：

名称 描述
capability 编解码能力指针。
profile 编解码器配置文件。
levels 输出参数。指向级别数组的指针。
levelNum 输出参数。级别数组的元素数目。

返回：

如果执行成功，则返回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

参数：

名称 描述
capability 编解码能力指针。
profiles 输出参数。指向配置文件数组的指针。
profileNum 输出参数。配置文件数组的元素数目。

返回：

如果执行成功，则返回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

参数：

名称 描述
capability 视频编解码能力指针。不能填入音频编解码器能力指针。
frameRateRange 输出参数。视频帧率范围。

返回：

如果执行成功，则返回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

参数：

名称 描述
capability 视频编解码能力指针。不能填入音频编解码器能力指针。
width 视频水平像素数。
height 视频垂直像素数。
frameRateRange 输出参数。视频帧率范围。

返回：

如果执行成功，则返回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

参数：

名称 描述
capability 视频编解码能力指针。不能填入音频编解码器能力指针。
heightAlignment 输出参数。视频高度对齐。

返回：

如果执行成功，则返回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

参数：

名称 描述
capability 视频编解码能力指针。不能填入音频编解码器能力指针。
heightRange 输出参数。视频高度范围。

返回：

如果执行成功，则返回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

参数：

名称 描述
capability 视频编解码能力指针。不能填入音频编解码器能力指针。
width 视频水平像素数。
heightRange 输出参数。视频高度范围。

返回：

如果执行成功，则返回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

参数：

名称 描述
capability 视频编解码能力指针。不能填入音频编解码器能力指针。
pixelFormats 输出参数。指向视频像素格式数组的指针。
pixelFormatNum 输出参数。像素格式数组的元素数目。

返回：

如果执行成功，则返回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

参数：

名称 描述
capability 视频编解码能力指针。不能填入音频编解码器能力指针。
widthAlignment 输出参数。视频宽度对齐

返回：

如果执行成功，则返回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

参数：

名称 描述
capability 视频编解码能力指针。不能填入音频编解码器能力指针。
widthRange 输出参数。视频宽度范围

返回：

如果执行成功，则返回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

参数：

名称 描述
capability 视频编解码能力指针。不能填入音频编解码器能力指针。
height 视频垂直像素数。
widthRange 输出参数。视频宽度范围。

返回：

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

起始版本：

10

OH_AVCapability_IsEncoderBitrateModeSupported()

bool OH_AVCapability_IsEncoderBitrateModeSupported (OH_AVCapability *capability, OH_BitrateMode bitrateMode)

描述：

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

\@syscap SystemCapability.Multimedia.Media.CodecBase

参数：

名称 描述
capability 编码器能力指针。不能填入解码器能力指针。
bitrateMode 比特率模式。

返回：

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

起始版本：

10

OH_AVCapability_IsHardware()

bool OH_AVCapability_IsHardware (OH_AVCapability *capability)

描述：

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

\@syscap SystemCapability.Multimedia.Media.CodecBase

参数：

名称 描述
capability 编解码能力指针。

返回：

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

起始版本：

10

OH_AVCapability_IsVideoSizeSupported()

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

描述：

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

\@syscap SystemCapability.Multimedia.Media.CodecBase

参数：

名称 描述
capability 视频编解码能力指针。不能填入音频编解码器能力指针。
width 视频水平像素数。
height 视频垂直像素数。

返回：

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

起始版本：

10

OH_AVCodec_GetCapability()

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

描述：

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

\@syscap SystemCapability.Multimedia.Media.CodecBase

参数：

名称 描述
mime MIME类型描述字符串，请参阅AVCODEC_MIMETYPE。
isEncoder 编码器为true，解码器为false。

返回：

如果现有编解码器匹配，则返回能力实例， 如果指定的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 MIME类型描述字符串，请参阅AVCODEC_MIMETYPE。
isEncoder 编码器为true，解码器为false。
category 编解码器类别。

返回：

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

起始版本：

10

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Native API

harmony 鸿蒙AVDemuxer

harmony 鸿蒙AVMuxer

harmony 鸿蒙AVScreenCapture

harmony 鸿蒙AVSource

harmony 鸿蒙AudioDecoder

harmony 鸿蒙AudioEncoder

harmony 鸿蒙CodecBase

harmony 鸿蒙Core

harmony 鸿蒙Drawing

0  赞
  • 所属分类： 后端技术
  • 本文标签：
  • 版权声明： 原创文章如转载，请注明本文链接: https://www.seaxiang.com/blog/4ba636cc3f224060b257501c28b38b87
热门推荐
标签云
Linux Java Spring Spring Boot docker 大数据 前端 生活 maven golang 软件 spring cloud fintech mac vscode 其他 区块链 以太坊 V神 开发者 技术 股票 git greenplum 分布式事务 chrome mysql flink kafka 设计模式 原理 鸿蒙 seo
最新文章
本文目录