HarmonyOS NEXT 6.1.1（API 24）在多媒体框架AVCodec Kit中带来了两项重要更新：一是原生支持古典视频格式Cinepak的编解码，二是开放了DRM安全解码器的硬件级筛选机制。前者解决了老旧媒体资源的兼容问题，后者则通过物理芯片层的可信执行环境（TEE）构建了防内存窃取的闭环安全通道。本文将深入AVCodec NDK核心，解析这些新能力的具体用法和实战要点。
一、AVCodec Kit能力概览
AVCodec Kit是HarmonyOS多媒体的核心引擎，管理芯片底层的硬件编解码加速器（VPU）和系统混音通道。它由三大子模块构成：
- 能力查询子系统（AVCodec Capabilities）：向操作系统查询物理芯片是否支持特定格式、最大并发实例数等。
- 解封装与编解码子系统（Demuxer / Codec）：从容器中剥离基础流，送入软件或硬件解码器，输出PCM音频波形和NV21/RGBA视频纹理。
- 安全链路集成（Secure Link & DRM Support）：与DRM Kit深度绑定，通过物理安全通道防止解密后的视频帧在非安全内存区域停留。
二、6.1.1新增特性详解
1. Cinepak格式原生承接
Cinepak是早期Windows 95和QuickTime时代的编解码器，常用于经典教学光盘、怀旧游戏内置CG。此前开发者需要自行编译FFmpeg静态库才能播放，增加了包体积。现在系统直接收录了MIME类型“video/cinepak”，调用统一且能显著降低软件解码能耗。
2. DRM安全解码器物理自适应筛选
播放受DRM保护的高清/4K内容时，传统软件解码器容易被内存Dump窃取帧。新策略强制硬件解码优先，一旦启用安全通路，解码输出的原始YUV帧会被锁死在芯片保护区域（TEE），直接输出到显示硬件，杜绝系统截图或第三方App获取。
三、NDK实战：架设DRM安全解码管线
以下C++代码展示了在Native层创建安全解码器的标准流程：
- #include <multimedia/player_framework/native_avcodec_videodecoder.h>
- #include <multimedia/player_framework/native_avcapability.h>
- #include <multimedia/drm_framework/native_drm_common.h>
- OH_AVCodec* SetupDrmSecureDecoder(const char* mimeType, OH_MediaKeySession* drmSession, void* nativeWindow) {
- // 1. 查询硬件解码能力
- OH_AVCapability* capability = OH_AVCodec_GetCapability(mimeType, false);
- if (!capability) return nullptr;
- const char* codecName = OH_AVCapability_GetName(capability);
-
- // 2. 实例化解码器
- OH_AVCodec* videoDecoder = OH_VideoDecoder_CreateByName(codecName);
- if (!videoDecoder) return nullptr;
-
- // 3. 注入DRM解密配置（必须在Prepare之前完成）
- int32_t drmRet = OH_VideoDecoder_SetDecryptionConfig(videoDecoder, drmSession, true); // true强制走安全链路
- if (drmRet != AV_ERR_OK) {
- OH_VideoDecoder_Destroy(videoDecoder);
- return nullptr;
- }
-
- // 4. 绑定Surface（安全解码器仅支持Surface模式）
- OH_VideoDecoder_SetSurface(videoDecoder, nativeWindow);
-
- // 5. 准备并启动
- OH_VideoDecoder_Prepare(videoDecoder);
- return videoDecoder;
- }
关键点：在OH_VideoDecoder_SetDecryptionConfig中传入true表示强制启用安全链路。若设备不支持安全解码器，该调用会返回错误，从而防范降级风险。
四、ArkTS UI交互：仿真筛选决策面板
为了可视化展示筛选逻辑，可创建一个模拟控制面板，让用户选择MIME格式并切换DRM强制开关，观察系统决策结果。以下为核心组件片段：
- import { router } from '@kit.ArkUI';
- class CodecDesc {
- name: string = '';
- isHardware: boolean = false;
- supportDrmSecure: boolean = false;
- maxResolution: string = '';
- }
- @Entry
- @Component
- struct AvCodecEnhanceDetail {
- @State selectedMime: string = 'video/hevc';
- @State requireDrmSecure: boolean = false;
- @State filterLogs: string = '[SYSTEM] AVCodec 物理特性探测总线空闲。\n';
-
- private mockSpecs: Record<string, CodecDesc> = {
- 'video/avc': { name: 'HwVideoDecoder.AVC', isHardware: true, supportDrmSecure: true, maxResolution: '4K 60fps' },
- 'video/hevc': { name: 'HwVideoDecoder.HEVC', isHardware: true, supportDrmSecure: true, maxResolution: '8K 30fps' },
- 'video/vvc': { name: 'HwVideoDecoder.VVC', isHardware: true, supportDrmSecure: false, maxResolution: '4K 30fps' },
- 'video/cinepak': { name: 'SwVideoDecoder.CINEPAK', isHardware: false, supportDrmSecure: false, maxResolution: '720P 30fps' }
- };
-
- executeFilterAction() {
- // 模拟筛选逻辑，输出到filterLogs
- // 具体实现见原文，此处省略
- }
-
- build() {
- // UI布局：包括MIME选择、DRM开关、探测按钮和日志输出
- }
- }
运行效果示例：
- 选择Cinepak且未开启DRM时，日志显示“检测到古典格式，芯片无VPU加速，物理回落软解通道”。
- 选择HEVC并开启DRM L1时，日志显示“物理对接成功！已筛选出TEE隔离级别安全解码器”，并警告RAW帧被锁定。
- 选择不支持安全链路的格式（如VVC）强制开启DRM时，日志显示“❌灾难性降级，强制中断解码管线”。
五、避坑指南
1. 安全解码器只能绑定Surface
一旦启用了OH_VideoDecoder_SetDecryptionConfig，解码器强制仅支持Surface渲染模式。若尝试通过输出回调获取原始Buffer内存帧，系统会返回NULL并抛出异常。因此，必须将解码器输出直接连接到NativeWindow，不能走内存读取路径。
2. Cinepak为软件解码，注意功耗
Cinepak只在系统层面做了软件解码的原生包装，硬件VPU中没有固化硬解码模块。大量播放时建议将帧率控制在30fps以内，避免全分辨率上屏导致CPU负载过高、设备发热降频。
3. DRM密钥配置必须严格遵循时序
正确的拓扑顺序是：先完成解封装，再获取DRM密钥并初始化MediaKeySession，然后调用SetDecryptionConfig配置，最后执行OH_VideoDecoder_Prepare。如果提前输入数据，解码器会报“DRM_KEY_NOT_FOUND”错误，导致黑屏。
六、总结
HarmonyOS 6.1.1通过AVCodec Kit的升级，既拥抱了古典格式（Cinepak），又强化了版权保护能力（DRM安全解码器）。开发者可以利用底层查询机制和动态熔断策略，在兼容老旧内容的同时，为付费内容构建硬件级安全防线。掌握上述API和注意事项，能够让多媒体应用在兼容性与安全性上达到新的高度。 |
发表于