harmony 鸿蒙native_avcapability.h

2025-06-12
浏览 (5)

native_avcapability.h

概述

声明用于编解码能力查询到的Native API。

库： libnative_media_codecbase.so

起始版本： 10

相关模块：AVCapability

汇总

结构体

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

类型定义

名称	描述
typedef struct OH_AVRange OH_AVRange	范围包含最小值和最大值。
typedef enum OH_AVCodecCategory OH_AVCodecCategory	编解码器类别。
typedef enum OH_AVCapabilityFeature OH_AVCapabilityFeature	可以在特定编解码器场景中使用的可选特性。

枚举

名称	描述
OH_AVCodecCategory { HARDWARE = 0, SOFTWARE }	编解码器类别。
OH_AVCapabilityFeature { VIDEO_ENCODER_TEMPORAL_SCALABILITY = 0, VIDEO_ENCODER_LONG_TERM_REFERENCE = 1, VIDEO_LOW_LATENCY = 2 }	可以在特定编解码器场景中使用的可选特性。

函数

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