大网数据广告活动
OpenHarmony 设备与应用开发

典型场景的视频编码配置

· 52CE 我爱测

此文档描述了AVCodec视频编码能力在不同应用场景下的推荐配置参数,供开发者根据实际应用场景进行视频编码应用的开发。

典型场景的视频编码配置

此文档描述了AVCodec视频编码能力在不同应用场景下的推荐配置参数,供开发者根据实际应用场景进行视频编码应用的开发。

视频编码在短距投屏(通常指10米以内的多个设备间进行屏幕编码投递)、视频通话、视频会议、直播、视频编辑、视频分享等场景均有广泛使用,按照体验要求,上述场景可归纳划分为低时延、实时流媒体、离线编码三大类别应用场景。

本文将给出上述三大类别应用场景下视频编码的推荐参数配置,方便开发者根据不同应用场景下的需求进行参数配置选择。

通用开发步骤

在CMake脚本中链接动态库

target_link_libraries(sample PUBLIC libnative_media_codecbase.so)
target_link_libraries(sample PUBLIC libnative_media_core.so)
target_link_libraries(sample PUBLIC libnative_media_venc.so)

说明:

上述'sample'字样仅为示例,此处由开发者根据实际工程目录自定义。

添加头文件

#include <multimedia/player_framework/native_avcodec_videoencoder.h>
#include <multimedia/player_framework/native_avcapability.h>
#include <multimedia/player_framework/native_avcodec_base.h>
#include <multimedia/player_framework/native_avformat.h>
#include <fstream>

低时延场景

低时延编码场景包括短距投屏、视频通话、视频会议、连麦直播等对端到端时延要求较高的交互式应用。

开发指导

基础编码流程请参考视频编码,下面仅针对编码器配置阶段做具体说明。

  1. 配置编码器参数。

    在配置编码器参数阶段,配置适合低时延编码场景的参数。

    低时延短距投屏场景,典型分辨率的编码参数(以H.265为例)推荐如下:

    分辨率(px) 帧率(fps) 码率(kbps) 接入帧间隔(ms) 码控模式
    2560x1600 60 5000 5000 CBR
    1920x1080 60 3500 5000 CBR
    1280x720 60 2500 5000 CBR
    960x540 60 1500 5000 CBR

    低时延视频通话、视频会议、连麦直播等场景,典型分辨率的编码参数(以H.265为例)推荐如下:

    分辨率(px) 帧率(fps) 码率(kbps) 接入帧间隔(ms) 码控模式
    1920x1080 30 1500 -1 CBR
    1280x720 30 1000 -1 CBR
    960x540 30 700 -1 CBR
    640x360 30 550 -1 CBR
    320x180 20 200 -1 CBR

    注意:

    接入帧间隔-1表示只有第一帧为接入帧,开发者可以根据传输情况和画质情况,在运行过程中动态配置编码器参数,实现插入新的接入帧(IDR)功能。

    如下以低时延视频通话场景为示例,其示例中的变量说明如下:

    videoEnc:视频编码器实例的指针。创建方式可参考视频编码Surface模式“步骤-2:创建编码器实例对象”。

    // 1. 创建AVFormat参数实例。
    OH_AVFormat *format = OH_AVFormat_Create(); 
    // 2. 填充编码参数键值对(以1080p@30fps SDR输入源为例)。
    OH_AVFormat_SetIntValue(format, OH_MD_KEY_WIDTH, 1920); // 必须配置,视频像素宽。
    OH_AVFormat_SetIntValue(format, OH_MD_KEY_HEIGHT, 1080); // 必须配置,视频像素高。
    OH_AVFormat_SetIntValue(format, OH_MD_KEY_PIXEL_FORMAT, AV_PIXEL_FORMAT_NV12); // 必须配置,视频源数据排布格式。
    OH_AVFormat_SetIntValue(format, OH_MD_KEY_RANGE_FLAG, 0); // VUI(视频可用性信息),视频YUV值域标志,0:limited range 1:full range。
    OH_AVFormat_SetIntValue(format, OH_MD_KEY_COLOR_PRIMARIES, OH_ColorPrimary::COLOR_PRIMARY_BT709); // VUI,视频源色域。
    OH_AVFormat_SetIntValue(format, OH_MD_KEY_TRANSFER_CHARACTERISTICS, OH_TransferCharacteristic::TRANSFER_CHARACTERISTIC_BT709); // VUI,OETF/EOTF曲线。
    OH_AVFormat_SetIntValue(format, OH_MD_KEY_MATRIX_COEFFICIENTS, OH_MatrixCoefficient::MATRIX_COEFFICIENT_BT709); // VUI,YUV和RGB转换矩阵。
    OH_AVFormat_SetIntValue(format, OH_MD_KEY_PROFILE, OH_HEVCProfile::HEVC_PROFILE_MAIN); // 视频编码器profile。
    OH_AVFormat_SetDoubleValue(format, OH_MD_KEY_FRAME_RATE, 30.0); // 必须配置,视频帧率。
    OH_AVFormat_SetIntValue(format, OH_MD_KEY_I_FRAME_INTERVAL, -1); // 必须配置,接入帧间隔。
    OH_AVFormat_SetIntValue(format, OH_MD_KEY_VIDEO_ENCODE_BITRATE_MODE, OH_BitrateMode::BITRATE_MODE_CBR); // 必须配置,码控模式配置为CBR。
    OH_AVFormat_SetLongValue(format, OH_MD_KEY_BITRATE, 1500000); // 必须配置,设置码率,单位为bps。   
    // 3. 配置视频编码器的编码参数。
    int32_t ret = OH_VideoEncoder_Configure(videoEnc, format);
    if (ret != AV_ERR_OK) {
        // 异常处理。
    }
    // 4. 配置完成后销毁AVFormat实例。
    OH_AVFormat_Destroy(format);
    
  2. (可选)在运行过程中动态配置编码器参数。

    详情可参考视频编码Surface模式“步骤-9:OH_VideoEncoder_SetParameter()在运行过程中动态配置编码器参数”。

    // 1. 创建AVFormat参数实例。
    OH_AVFormat *format = OH_AVFormat_Create();
    // 2. 填充编码参数键值对(动态请求IDR帧)。
    OH_AVFormat_SetIntValue(format, OH_MD_KEY_REQUEST_I_FRAME, 1);
    // 3. 设置编码器参数生效。
    ret = OH_VideoEncoder_SetParameter(videoEnc, format);
    if (ret != AV_ERR_OK) {
        // 异常处理。
    }
    // 4. 配置完成后销毁AVFormat实例。
    OH_AVFormat_Destroy(format);
    

    如果需要适配网络波动,推荐结合采用时域可分层视频编码配置。

从API版本26.0.0开始,在支持CBRHQ(高质量恒定码率模式)的平台下,推荐使用CBRHQ码控方式替代CBR(恒定码率)码控方式。如果配置了CBRHQ但是平台不支持,会自动使用CBR码控模式替代。

以视频通话场景为例,典型分辨率的编码参数(以H.265为例)推荐如下:

分辨率(px) 帧率(fps) 码率(kbps) 接入帧间隔(ms) 码控模式
1920x1080 30 1500 -1 CBRHQ
1280x720 30 1000 -1 CBRHQ
960x540 30 700 -1 CBRHQ
640x360 30 550 -1 CBRHQ
320x180 20 200 -1 CBRHQ

CBRHQ码控方式配置如下:

// 1. 创建AVFormat参数实例。
OH_AVFormat *format = OH_AVFormat_Create();
// 2. 填充编码参数键值对(以1080p@15fps SDR输入源为例)。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_WIDTH, 1080); // 必须配置,视频像素宽。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_HEIGHT, 1920); // 必须配置,视频像素高。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_PIXEL_FORMAT, AV_PIXEL_FORMAT_NV12); // 必须配置,视频源数据排布格式。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_RANGE_FLAG, 0); // VUI,视频YUV值域标志,0:limited range 1:full range。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_COLOR_PRIMARIES, OH_ColorPrimary::COLOR_PRIMARY_BT709); // VUI,视频源色域。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_TRANSFER_CHARACTERISTICS, OH_TransferCharacteristic::TRANSFER_CHARACTERISTIC_BT709); // VUI,OETF/EOTF曲线。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_MATRIX_COEFFICIENTS, OH_MatrixCoefficient::MATRIX_COEFFICIENT_BT709); // VUI,YUV和RGB转换矩阵。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_PROFILE, OH_HEVCProfile::HEVC_PROFILE_MAIN); // 视频编码器profile。
OH_AVFormat_SetDoubleValue(format, OH_MD_KEY_FRAME_RATE, 15.0); // 必须配置,视频帧率。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_I_FRAME_INTERVAL,10000); // 必须配置,接入帧间隔,单位为ms。

// 3. 查询CBRHQ支持情况选择合适的码控配置。
OH_AVCapability *cap = OH_AVCodec_GetCapability(OH_AVCODEC_MIMETYPE_VIDEO_HEVC, true);
if (cap == nullptr || !OH_AVCapability_IsEncoderBitrateModeSupported(cap, OH_BitrateMode::BITRATE_MODE_CBR_HIGH_QUALITY)) {
    // 不支持CBRHQ,使用CBR代替。
    OH_AVFormat_SetIntValue(format, OH_MD_KEY_VIDEO_ENCODE_BITRATE_MODE, OH_BitrateMode::BITRATE_MODE_CBR); // 必须配置,码控模式配置为CBR。
} else {
    // 支持CBRHQ,配置CBRHQ码控模式。
    OH_AVFormat_SetIntValue(format, OH_MD_KEY_VIDEO_ENCODE_BITRATE_MODE, OH_BitrateMode::BITRATE_MODE_CBR_HIGH_QUALITY); // 必须配置,码控模式配置为CBRHQ。
}
OH_AVFormat_SetLongValue(format, OH_MD_KEY_BITRATE, 1520000); // 必须配置,设置码率,单位为bps。

// 4. 配置视频编码器的编码参数。
int32_t ret = OH_VideoEncoder_Configure(videoEnc, format);
if (ret != AV_ERR_OK) {
    // 异常处理。
}
// 5. 配置完成后销毁AVFormat实例。
OH_AVFormat_Destroy(format);

实时流媒体编码

实时流媒体编码场景包括泛娱乐直播、游戏直播等对视频端到端时延要求不高的应用场景。

开发指导

基础编码流程请参考视频编码,下面仅针对编码器配置阶段,对配置实时流媒体编码场景的参数做具体说明。

娱乐直播场景,典型分辨率的编码参数(以H.265为例)推荐如下:

分辨率(px) 帧率(fps) 码率(kbps) 接入帧间隔(ms) 码控模式
1920x1080 25 3000 2000 VBR
1080x720 25 1500 2000 VBR
960x544 25 1000 2000 VBR
864x480 25 800 2000 VBR

游戏直播场景,典型分辨率的编码参数(以H.265为例)推荐如下:

分辨率(px) 帧率(fps) 码率(kbps) 接入帧间隔(ms) 码控模式
1920x1080 60 6000 5000 VBR
// 1. 创建AVFormat参数实例。
OH_AVFormat *format = OH_AVFormat_Create();
// 2. 填充编码参数键值对(以1080p@25fps SDR输入源为例)。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_WIDTH, 1080); // 必须配置,视频像素宽。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_HEIGHT, 1920); // 必须配置,视频像素高。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_PIXEL_FORMAT, AV_PIXEL_FORMAT_NV12); // 必须配置,视频源数据排布格式。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_RANGE_FLAG, 0); // VUI,视频YUV值域标志,0:limited range 1:full range。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_COLOR_PRIMARIES, OH_ColorPrimary::COLOR_PRIMARY_BT709); // VUI,视频源色域。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_TRANSFER_CHARACTERISTICS, OH_TransferCharacteristic::TRANSFER_CHARACTERISTIC_BT709); // VUI,OETF/EOTF曲线。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_MATRIX_COEFFICIENTS, OH_MatrixCoefficient::MATRIX_COEFFICIENT_BT709); // VUI,YUV和RGB转换矩阵。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_PROFILE, OH_HEVCProfile::HEVC_PROFILE_MAIN); // 视频编码器profile。
OH_AVFormat_SetDoubleValue(format, OH_MD_KEY_FRAME_RATE, 25.0); // 必须配置,视频帧率。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_I_FRAME_INTERVAL, 2000); // 必须配置,接入帧间隔,单位为ms。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_VIDEO_ENCODE_BITRATE_MODE, OH_BitrateMode::BITRATE_MODE_VBR); // 必须配置,码控模式配置为VBR。
OH_AVFormat_SetLongValue(format, OH_MD_KEY_BITRATE, 3000000); // 必须配置,设置码率,单位为bps。
// 3. 配置视频编码器的编码参数。
int32_t ret = OH_VideoEncoder_Configure(videoEnc, format);
if (ret != AV_ERR_OK) {
    // 异常处理。
}
// 4. 配置完成后销毁AVFormat实例。
OH_AVFormat_Destroy(format);

从API version 20开始,在支持SQR(质量稳定码控)的平台下,推荐使用SQR码控方式替代VBR(可变码率)码控方式。

娱乐直播场景,典型分辨率的编码参数(以H.265为例)推荐如下:

分辨率(px) 帧率(fps) SQR质量因子 峰值码率(kbps) 接入帧间隔(ms) 码控模式
1920x1080 25 25 3000 2000 SQR
1080x720 25 25 1500 2000 SQR
960x544 25 25 1000 2000 SQR
864x480 25 25 800 2000 SQR

游戏直播场景,典型分辨率的编码参数(以H.265为例)推荐如下:

分辨率(px) 帧率(fps) SQR质量因子 峰值码率(kbps) 接入帧间隔(ms) 码控模式
1920x1080 60 25 6000 5000 SQR

SQR码控方式配置如下:

// 1. 创建AVFormat参数实例。
OH_AVFormat *format = OH_AVFormat_Create();
// 2. 填充编码参数键值对(以1080p@25fps SDR输入源为例)。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_WIDTH, 1080); // 必须配置,视频像素宽。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_HEIGHT, 1920); // 必须配置,视频像素高。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_PIXEL_FORMAT, AV_PIXEL_FORMAT_NV12); // 必须配置,视频源数据排布格式。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_RANGE_FLAG, 0); // VUI,视频YUV值域标志,0:limited range 1:full range。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_COLOR_PRIMARIES, OH_ColorPrimary::COLOR_PRIMARY_BT709); // VUI,视频源色域。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_TRANSFER_CHARACTERISTICS, OH_TransferCharacteristic::TRANSFER_CHARACTERISTIC_BT709); // VUI,OETF/EOTF曲线。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_MATRIX_COEFFICIENTS, OH_MatrixCoefficient::MATRIX_COEFFICIENT_BT709); // VUI,YUV和RGB转换矩阵。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_PROFILE, OH_HEVCProfile::HEVC_PROFILE_MAIN); // 视频编码器profile。
OH_AVFormat_SetDoubleValue(format, OH_MD_KEY_FRAME_RATE, 25.0); // 必须配置,视频帧率。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_I_FRAME_INTERVAL, 2000); // 必须配置,接入帧间隔,单位为ms。

// 3. 查询SQR支持情况选择合适的码控配置。
OH_AVCapability *cap = OH_AVCodec_GetCapability(OH_AVCODEC_MIMETYPE_VIDEO_HEVC, true);
if (cap == nullptr || !OH_AVCapability_IsEncoderBitrateModeSupported(cap, OH_BitrateMode::BITRATE_MODE_SQR)) { 
    // 不支持SQR,使用VBR代替。
    OH_AVFormat_SetIntValue(format, OH_MD_KEY_VIDEO_ENCODE_BITRATE_MODE, OH_BitrateMode::BITRATE_MODE_VBR); // 必须配置,码控模式配置为VBR。
    OH_AVFormat_SetLongValue(format, OH_MD_KEY_BITRATE, 3000000); // 必须配置,设置码率,单位为bps。
} else {
    // 支持SQR,配置SQR码控参数。
    OH_AVFormat_SetIntValue(format, OH_MD_KEY_VIDEO_ENCODE_BITRATE_MODE, OH_BitrateMode::BITRATE_MODE_SQR); // 必须配置,码控模式配置为SQR。
    OH_AVFormat_SetIntValue(format, OH_MD_KEY_SQR_FACTOR, 25); // 必选配置,设置SQR质量因子,取值范围为[0, 51],数值越小画质越高。
    OH_AVFormat_SetLongValue(format, OH_MD_KEY_MAX_BITRATE, 3000000); // 必须配置,设置峰值码率,单位为bps。
}

// 4. 配置视频编码器的编码参数。
int32_t ret = OH_VideoEncoder_Configure(videoEnc, format);
if (ret != AV_ERR_OK) {
    // 异常处理。
}
// 5. 配置完成后销毁AVFormat实例。
OH_AVFormat_Destroy(format);

离线编码场景

离线编码场景包括视频编辑、视频分享等多种应用场景。

开发指导

基础编码流程请参考视频编码,下面仅针对编码器配置阶段,对配置离线编码场景的编码参数做具体说明。

视频编辑场景,典型分辨率的编码参数(以H.265为例)推荐如下:

分辨率(px) 帧率(fps) 码率(kbps) 接入帧间隔(ms) 码控模式
3840x2160 30 25000 5000 VBR
2560x1440 30 15000 5000 VBR
1920x1080 30 10000 5000 VBR
1280x720 30 5000 5000 VBR
854x480 30 2000 5000 VBR

视频分享场景,典型分辨率的编码参数(以H.265为例)推荐如下:

分辨率(px) 帧率(fps) 码率(kbps) 接入帧间隔(ms) 码控模式
3840x2160 30 5600 5000 VBR
2560x1440 30 4900 5000 VBR
1920x1080 30 2100 5000 VBR
1280x720 30 1400 5000 VBR
854x480 30 400 5000 VBR
// 1. 创建AVFormat参数实例。
OH_AVFormat *format = OH_AVFormat_Create();
// 2. 填充编码参数键值对(以1080p@30fps SDR输入源为例)。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_WIDTH, 1920); // 必须配置,视频像素宽。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_HEIGHT, 1080); // 必须配置,视频像素高。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_PIXEL_FORMAT, AV_PIXEL_FORMAT_NV12); // 必须配置,视频源数据排布格式。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_RANGE_FLAG, 0); // VUI,视频YUV值域标志,0:limited range 1:full range。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_COLOR_PRIMARIES, OH_ColorPrimary::COLOR_PRIMARY_BT709); // VUI,视频源色域。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_TRANSFER_CHARACTERISTICS, OH_TransferCharacteristic::TRANSFER_CHARACTERISTIC_BT709); // VUI,OETF/EOTF曲线。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_MATRIX_COEFFICIENTS, OH_MatrixCoefficient::MATRIX_COEFFICIENT_BT709); // VUI,YUV和RGB转换矩阵。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_PROFILE, OH_HEVCProfile::HEVC_PROFILE_MAIN); // 视频编码器profile。
OH_AVFormat_SetDoubleValue(format, OH_MD_KEY_FRAME_RATE, 30.0); // 必须配置,视频帧率。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_I_FRAME_INTERVAL, 5000); // 必须配置,接入帧间隔,单位为ms。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_VIDEO_ENCODE_BITRATE_MODE, OH_BitrateMode::BITRATE_MODE_VBR); // 必须配置,码控模式配置为VBR。
OH_AVFormat_SetLongValue(format, OH_MD_KEY_BITRATE, 2100000); // 必须配置,设置码率,单位为bps。
// 3. 配置视频编码器的编码参数。
int32_t ret = OH_VideoEncoder_Configure(videoEnc, format);
if (ret != AV_ERR_OK) {
    // 异常处理。
}
// 4. 配置完成后销毁AVFormat实例。
OH_AVFormat_Destroy(format);

从API version 20开始,在支持SQR(质量稳定码控)的平台下,推荐使用SQR码控方式替代VBR(可变码率)码控方式。

视频编辑场景,典型分辨率的编码参数(以H.265为例)推荐如下:

分辨率(px) 帧率(fps) SQR质量因子 峰值码率(kbps) 接入帧间隔(ms) 码控模式
3840x2160 30 25 25000 5000 SQR
2560x1440 30 25 15000 5000 SQR
1920x1080 30 25 10000 5000 SQR
1280x720 30 25 5000 5000 SQR
854x480 30 25 2000 5000 SQR

视频分享场景,典型分辨率的编码参数(以H.265为例)推荐如下:

分辨率(px) 帧率(fps) SQR质量因子 峰值码率(kbps) 接入帧间隔(ms) 码控模式
3840x2160 30 25 5600 5000 SQR
2560x1440 30 25 4900 5000 SQR
1920x1080 30 25 2100 5000 SQR
1280x720 30 25 1400 5000 SQR
854x480 30 25 400 5000 SQR

SQR码控方式配置如下:

// 1. 创建AVFormat参数实例。
OH_AVFormat *format = OH_AVFormat_Create();
// 2. 填充编码参数键值对(以1080p@30fps SDR输入源为例)。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_WIDTH, 1920); // 必须配置,视频像素宽。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_HEIGHT, 1080); // 必须配置,视频像素高。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_PIXEL_FORMAT, AV_PIXEL_FORMAT_NV12); // 必须配置,视频源数据排布格式。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_RANGE_FLAG, 0); // VUI,视频YUV值域标志,0:limited range 1:full range。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_COLOR_PRIMARIES, OH_ColorPrimary::COLOR_PRIMARY_BT709); // VUI,视频源色域。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_TRANSFER_CHARACTERISTICS, OH_TransferCharacteristic::TRANSFER_CHARACTERISTIC_BT709); // VUI,OETF/EOTF曲线。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_MATRIX_COEFFICIENTS, OH_MatrixCoefficient::MATRIX_COEFFICIENT_BT709); // VUI,YUV和RGB转换矩阵。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_PROFILE, OH_HEVCProfile::HEVC_PROFILE_MAIN); // 视频编码器profile。
OH_AVFormat_SetDoubleValue(format, OH_MD_KEY_FRAME_RATE, 30.0); // 必须配置,视频帧率。
OH_AVFormat_SetIntValue(format, OH_MD_KEY_I_FRAME_INTERVAL, 5000); // 必须配置,接入帧间隔,单位为ms。

// 3. 查询SQR支持情况选择合适的码控配置。
OH_AVCapability *cap = OH_AVCodec_GetCapability(OH_AVCODEC_MIMETYPE_VIDEO_HEVC, true);
if (cap == nullptr || !OH_AVCapability_IsEncoderBitrateModeSupported(cap, OH_BitrateMode::BITRATE_MODE_SQR)) { 
    // 不支持SQR,使用VBR代替。
    OH_AVFormat_SetIntValue(format, OH_MD_KEY_VIDEO_ENCODE_BITRATE_MODE, OH_BitrateMode::BITRATE_MODE_VBR); // 必须配置,码控模式配置为VBR。
    OH_AVFormat_SetLongValue(format, OH_MD_KEY_BITRATE, 2100000); // 必须配置,设置码率,单位为bps。
} else {
    // 支持SQR,配置SQR码控参数。
    OH_AVFormat_SetIntValue(format, OH_MD_KEY_VIDEO_ENCODE_BITRATE_MODE, OH_BitrateMode::BITRATE_MODE_SQR); // 必须配置,码控模式配置为SQR。
    OH_AVFormat_SetIntValue(format, OH_MD_KEY_SQR_FACTOR, 25); // 必选配置,设置SQR质量因子,取值范围为[0, 51],数值越小画质越高。
    OH_AVFormat_SetLongValue(format, OH_MD_KEY_MAX_BITRATE, 2100000); // 必须配置,设置峰值码率,单位为bps。
}

// 4. 配置视频编码器的编码参数。
int32_t ret = OH_VideoEncoder_Configure(videoEnc, format);
if (ret != AV_ERR_OK) {
    // 异常处理。
}
// 5. 配置完成后销毁AVFormat实例。
OH_AVFormat_Destroy(format);

注意事项

本指南的编码建议,在实际应用中还需要结合业务具体情况进行优化。在确定的码率下,视频编码的画质会因为所编码的视频内容的时空域复杂度不同而有较大差异。一般而言,运动复杂,画面纹理丰富的视频内容,在码率不足时容易出现模糊或马赛克,此时需要配置较高码率。

本文来自 OpenHarmony 文档贡献者,按 CC BY 4.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
OpenHarmony 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。