1# 获取支持的编解码能力 2 3不同设备支持的编解码能力存在差异，开发者在调用编解码或配置编解码器前，需要先查询当前系统支持的编解码器规格。 4 5开发者可以调用本模块的Native API接口，查询相关能力的支持情况。 6 7## 在 CMake 脚本中链接动态库 8 9``` cmake 10target_link_libraries(sample PUBLIC libnative_media_codecbase.so) 11``` 12 13## 开发步骤 14 15详细的API说明请参考[API文档](../../reference/apis-avcodec-kit/_a_v_capability.md)。 16 171. 添加头文件。 18 19 ```c 20 #include <multimedia/player_framework/native_avcapability.h> 21 #include <multimedia/player_framework/native_avcodec_base.h> 22 ``` 23 242. 获得能力。 25 26 ```c 27 // 根据mime type、是否编码器获得能力 28 OH_AVCapability *capability = OH_AVCodec_GetCapability(OH_AVCODEC_MIMETYPE_VIDEO_AVC, false); 29 30 // 根据mime type、是否编码器以及软硬件类别获得能力 31 OH_AVCapability *capability = OH_AVCodec_GetCapabilityByCategory(OH_AVCODEC_MIMETYPE_VIDEO_AVC, false, SOFTWARE); 32 ``` 33 343. 查询参数。 35 36 ```c 37 // 查询当前能力是否支持硬件 38 bool isHardware = OH_AVCapability_IsHardware(capability); 39 40 // 查询当前能力codec名称 41 const char *codecName = OH_AVCapability_GetName(capability); 42 43 // 查询当前能力中，最大支持的实例数 44 int32_t maxSupportedInstances = OH_AVCapability_GetMaxSupportedInstances(capability); 45 46 // 查询当前能力中，编码支持的码率范围 47 OH_AVRange bitrateRange; 48 int32_t bitrateRet = OH_AVCapability_GetEncoderBitrateRange(capability, &bitrateRange); 49 50 51 // 查询当前能力中，码控模式是否支持 52 bool isEncoderBitrateModeSupported = OH_AVCapability_IsEncoderBitrateModeSupported(capability, BITRATE_MODE_CBR); 53 54 // 查询当前能力中，编码质量范围 55 OH_AVRange qualityRange; 56 int32_t qualityRet = OH_AVCapability_GetEncoderQualityRange(capability, &qualityRange); 57 58 59 // 查询当前能力中，编码复杂度范围 60 OH_AVRange complexityRange; 61 int32_t complexityRet = OH_AVCapability_GetEncoderComplexityRange(capability, &complexityRange); 62 63 64 // 查询当前能力中，支持的音频采样率 65 const int32_t *sampleRates; 66 uint32_t sampleRateNum = 0; 67 int32_t sampleRet = OH_AVCapability_GetAudioSupportedSampleRates(capability, &sampleRates, &sampleRateNum); 68 69 70 // 查询当前能力中，支持的音频通道数范围 71 OH_AVRange channelCountRange; 72 int32_t channelCountRet = OH_AVCapability_GetAudioChannelCountRange(capability, &channelCountRange); 73 74 75 // 查询当前能力中，宽的对齐值 76 int32_t widthAlignment; 77 int32_t widthRet = OH_AVCapability_GetVideoWidthAlignment(capability, &widthAlignment); 78 79 80 // 查询当前能力中，高的对齐值 81 int32_t heightAlignment; 82 int32_t heightRet = OH_AVCapability_GetVideoHeightAlignment(capability, &heightAlignment); 83 84 85 // 查询当前能力中，高为1080时，宽的范围 86 OH_AVRange widthRange; 87 int32_t widthRangeRet = OH_AVCapability_GetVideoWidthRangeForHeight(capability, 1080, &widthRange); 88 89 90 // 查询当前能力中，宽为1920时，高的范围 91 OH_AVRange heightRange; 92 int32_t heightRangeRet = OH_AVCapability_GetVideoHeightRangeForWidth(capability, 1920, &heightRange); 93 94 95 // 查询当前能力中，宽的范围 96 OH_AVRange videoWidthRange; 97 int32_t videoWidthRet = OH_AVCapability_GetVideoWidthRange(capability, &videoWidthRange); 98 99 100 // 查询当前能力中，高的范围 101 OH_AVRange videoHeightRange; 102 int32_t videoHeightRet = OH_AVCapability_GetVideoHeightRange(capability, &videoHeightRange); 103 104 105 // 校验当前能力是否支持分辨率1080p 106 bool isVideoSizeSupported = OH_AVCapability_IsVideoSizeSupported(capability, 1920, 1080); 107 108 // 查询当前能力中，视频帧率范围 109 OH_AVRange frameRateRange; 110 int32_t videoFrameRet = OH_AVCapability_GetVideoFrameRateRange(capability, &frameRateRange); 111 112 113 // 查询当前能力中，分辨率为1920x1080时视频帧率范围 114 OH_AVRange frameRateRangeForSize; 115 int32_t ret = OH_AVCapability_GetVideoFrameRateRangeForSize(capability, 1920, 1080, &frameRateRangeForSize); 116 117 118 // 校验当前能力是否支持分辨率1080p、帧率30的场景 119 bool areVideoSizeAndFrameRateSupported = OH_AVCapability_AreVideoSizeAndFrameRateSupported(capability, 1920, 1080, 30); 120 121 // 查询当前能力中，支持的颜色格式以及个数 122 const int32_t *pixFormats; 123 uint32_t pixFormatNum = 0; 124 int32_t pixFormatRet = OH_AVCapability_GetVideoSupportedPixelFormats(capability, &pixFormats, &pixFormatNum); 125 126 127 // 查询当前能力中，支持的模板 128 const int32_t *profiles; 129 uint32_t profileNum = 0; 130 int32_t profilesRet = OH_AVCapability_GetSupportedProfiles(capability, &profiles, &profileNum); 131 132 133 // 查询当前能力中，特定模板情况下的等级范围 134 const int32_t *levels; 135 uint32_t levelNum = 0; 136 int32_t levelsRet = OH_AVCapability_GetSupportedLevelsForProfile(capability, 0, &levels, &levelNum); 137 138 // 检查编解码器是否支持配置文件和级别的特定组合 139 bool areProfileAndLevelSupported = OH_AVCapability_AreProfileAndLevelSupported(capability, AVC_PROFILE_BASELINE, 1); 140 ```