一、简介
Codec HDI（Hardware Device Interface）对上层媒体服务提供视频编解码的驱动能力接口，主要功能有获取组件编解码能力，创建、销毁编解码器对象，启停编解码器操作，编解码处理等。
Codec HDI 2.0接口依赖OpenMax IL的标准接口，Codec HDI通过调用封装好的libOMX_Core.z.so获取支持的编解码器组件并创建组件运行。
本文主要介绍OpenHarmony 5.x版本视频硬件编解码Codec HDI的适配方法。
注：5.x版本的AVPlayer播放器histreamer引擎调用的视频硬件编解码框架和AVCodec视频硬件编解码框架都会调用到av_codec_service系统服务，通过IPC与Codec HDI通信。
二、适配流程
配置codec_host 服务
vendor/{company}/{product}/hdf_config/uhdf/device_info.hcs 文件配置codec_host服务
以rk3568为例，配置如下文件：vendor/hihope/rk3568/hdf_config/uhdf/device_info.hcs
codec :: host {hostName = "codec_host";priority = 50;gid = ["codec_host", "uhdf_driver", "vendor_mpp_driver"];codec_omx_idl_device :: device {device0 :: deviceNode {policy = 2;priority = 100;moduleName = "libcodec_driver.z.so";serviceName = "codec_component_manager_service";deviceMatchAttr = "media_codec_capabilities";}}...
}
codec_component_manager_service 服务被视频硬件编解码服务调用，重点是这个服务的配置。
配置codec_capabilities hcs文件
添加 vendor/{company}/{product}/hdf_config/uhdf/media_codec/media_codec_capabilities.hcs文件，该文件主要描述芯片支持的硬件编解码组件的能力集。
根据codec_component_manager_service 服务配置的deviceMatchAttr，media_codec_capabilities.hcs文件的match_attr字段为media_codec_capabilities。
以rk3568为例，添加 vendor/hihope/rk3568/hdf_config/uhdf/media_codec/media_codec_capabilities.hcs 文件
root {module = "master";codec_config {match_attr = "media_codec_capabilities";use_openmax = true;// capsMask: 0x01, Adaptive playback; 0x02, Secure playback; 0x04, Tunnel playback.// allocateMask: 0x01, Input buffer allocated within the Codec module;// allocateMask: 0x02, Input buffer allocated by an external user;// allocateMask: 0x04, Output buffer allocated within the Codec module;// allocateMask: 0x08, Output buffer allocated by an external user.VideoHwEncoders {/* node name explanation -- HDF_video_hw_enc_avc_rk：**** HDF____________video_________hw___________________enc_________avc____rk** | | | | | |** HDF or OMX video or audio hardware or software encoder or decoder mime vendor*/HDF_video_hw_enc_avc_rk {role = 1;type = 1;name = "OMX.rk.video_encoder.avc";supportProfiles = [1, 32768, 2, 32768, 8, 32768];maxInst = 4;isSoftwareCodec = false;processModeMask = [];capsMask = [0x01];minBitRate = 1;maxBitRate = 40000000;minWidth = 144;minHeight = 144;maxWidth = 4096;maxHeight = 4096;widthAlignment = 2;heightAlignment = 2;minBlockCount = 99;maxBlockCount = 8160;minBlocksPerSecond = 99;maxBlocksPerSecond = 489600;blockSizeWidth = 16;blockSizeHeight = 16;supportPixelFmts = [28, 24, 20, 12];measuredFrameRate = [320, 240, 165, 165, 720, 480, 149, 149, 1280, 720, 73, 73, 1920, 1080, 18, 18];bitRateMode = [1, 2];minFrameRate = 1;maxFrameRate = 60;canSwapWidthHeight = true;}...}VideoHwDecoders {HDF_video_hw_dec_avc_rk {role = 1;type = 0;name = "OMX.rk.video_decoder.avc";supportProfiles = [1, 32768, 2, 32768, 8, 32768];maxInst = 6;isSoftwareCodec = false;processModeMask = [];capsMask = [0x01];minBitRate = 1;maxBitRate = 10000000;minWidth = 144;minHeight = 144;maxWidth = 4096;maxHeight = 4096;widthAlignment = 2;heightAlignment = 2;minBlockCount = 99;maxBlockCount = 34560;minBlocksPerSecond = 99;maxBlocksPerSecond = 2073600;blockSizeWidth = 16;blockSizeHeight = 16;supportPixelFmts = [24, 12, 20];measuredFrameRate = [320, 240, 617, 617, 720, 480, 559, 559, 1280, 720, 276, 276, 1920, 1080, 164, 164, 3840, 2160, 30, 30];bitRateMode = [];minFrameRate = 1;maxFrameRate = 60;canSwapWidthHeight = true;}...}}
}
该文件需根据实际芯片能力配置，name组件名根据OMX组件层的定义配置，其他参数尽量按实际配置，否则系统服务层可能因检验参数失败导致编解码异常。
编解码能力配置文件添加编译
vendor/{company}/{product}/hdf_config/uhdf//hdf.hcs 引入media_codec_capabilities.hcs
以rk3568为例，vendor/hihope/rk3568/hdf_config/uhdf/hdf.hcs 添加
+ #include "media_codec/media_codec_capabilities.hcs"
OMX Wrapper的封装
封装实现libOMX_Core.z.so，供Codec HDI通过dlopen调用。
不同厂商OMX组件层的实现是不同的，这里不再详细赘述。
三、适配验证
适配完成后可以通过应用调用AVPlayer播放码流验证。
开机后首次播放视频或kill av_codec_service进程后首次播放视频时，如果可以获取到可用的编解码组件会有如下打印：
I C02b32/HCODEC: [GetManager xxx] need to get ICodecComponentManager
I C02b32/HCODEC: [GetCapList xxx] GetComponentCapabilityList return xxx components
I C02b32/HCODEC: [HdiCapToUserCap xxx] ----- codecName: xxx.encoder.avc -----
I C02b32/HCODEC: [HdiCapToUserCap xxx] codecType: 0, mimeType: video/avc, maxInstance x
...
I C02b32/HCODEC: [HdiCapToUserCap xxx] ----- codecName: xxx.decoder.avc -----
I C02b32/HCODEC: [HdiCapToUserCap xxx] codecType: 1, mimeType: video/avc, maxInstance x
硬件解码组件创建成功，正常解码播放会有如下打印：
I C02b32/HCODEC: [0][dec.avc][Uninitialized][OnAllocateComponent xxx] create omx node xxx.decoder.avc succ
I C02b32/HCODEC: [ChangeStateTo xxx] Uninitialized -> Initialized
I C02b32/HCODEC: [ChangeStateTo xxx] Starting -> Running
)
)
