视频可变帧率
======

从API version 15开始，支持视频可变帧率。

本模块提供视频可变帧率功能的CAPI接口，通过调用本接口，可以在视频播放过程中根据视频内容动态调整屏幕刷新率，在保障视频播放流畅度的基础上节省屏幕显示功耗。

#### 适用场景

具有高帧率（>30fps）视频源的播放场景；视频帧率小于或等于30的场景建议以30Hz的刷新率运行。下图以播放一段60fps的视频为例，算法根据视频内容实时调整屏幕刷新率，调节过程中，当刷新率小于视频帧率时，显示前会丢弃部分视频帧以节省功耗。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/b0/v3/OdUaZG6TQkCcJ-jU0aI1dg/zh-cn_image_0000002625188179.png?HW-CC-KV=V1&HW-CC-Date=20260612T073509Z&HW-CC-Expire=86400&HW-CC-Sign=6752E6B0A605E7623170080C758F14014A5DC0F16FD853BA9FA5F75714CEA125)

#### 约束与限制

1.  只支持硬件解码后直接送显的视频播放场景。
2.  屏幕整体刷新率会被调整，建议在全屏播放、无弹幕、无动效的场景使用，否则会影响弹幕、动效的流畅度体验。
3.  依赖解码帧率配置，使用前需要正确配置OH\_MD\_KEY\_FRAME\_RATE属性。
4.  与硬件平台能力相关，当平台不支持时，接口不报错，内部能力不生效，不影响正常解码播放流程。

#### 开发步骤

基础解码功能请参考[视频解码开发指南](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/video-decoding)，下面仅针对于基础视频解码过程中存在的区别做具体说明。

1.  解码器配置阶段，添加视频可变帧率使能开关。
    
    示例中的变量说明如下：
    
    • videoDec：视频解码器实例的指针。创建方式参考[Surface模式下创建解码器实例对象](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/video-decoding#surface模式)。
    
    OH\_AVFormat \*format = OH\_AVFormat\_Create();
    int32\_t width = 1280; // 视频帧宽度。
    int32\_t height = 720; // 视频帧高度。
    int32\_t fps = 60; // 视频帧率。
    OH\_AVFormat\_SetIntValue(format, OH\_MD\_KEY\_WIDTH, width);
    OH\_AVFormat\_SetIntValue(format, OH\_MD\_KEY\_HEIGHT, height);
    OH\_AVFormat\_SetIntValue(format, OH\_MD\_KEY\_FRAME\_RATE, fps);
    OH\_AVFormat\_SetIntValue(format, OH\_MD\_KEY\_VIDEO\_DECODER\_OUTPUT\_ENABLE\_VRR, 1);
    int32\_t ret = OH\_VideoDecoder\_Configure(videoDec, format);
    if (ret != AV\_ERR\_OK) {
        // 异常处理。
    }
    OH\_AVFormat\_Destroy(format);
    
2.  （可选）视频播放过程中，动态开关视频可变帧率。
    
    如果用户在播放中开启了弹幕，为了避免本模块输出最终未在屏幕刷新率调节过程中生效，导致计算资源的浪费，可以动态关闭本模块。
    
    动态关闭如下：
    
    OH\_AVFormat \*format = OH\_AVFormat\_Create();
    OH\_AVFormat\_SetIntValue(format, OH\_MD\_KEY\_VIDEO\_DECODER\_OUTPUT\_ENABLE\_VRR, 0);
    OH\_VideoDecoder\_SetParameter(videoDec, format);
    OH\_AVFormat\_Destroy(format);
    
    动态开启如下：
    
    OH\_AVFormat \*format = OH\_AVFormat\_Create();
    OH\_AVFormat\_SetIntValue(format, OH\_MD\_KEY\_FRAME\_RATE, fps);
    OH\_AVFormat\_SetIntValue(format, OH\_MD\_KEY\_VIDEO\_DECODER\_OUTPUT\_ENABLE\_VRR, 1);
    OH\_VideoDecoder\_SetParameter(videoDec, format);
    OH\_AVFormat\_Destroy(format);