更新时间:2026-09-14 GMT+08:00
分享

视频动态调整配置参数

方法名称

int setCloudVideoConfig(String jsonStr)

功能描述

设置视频相关的动态配置,基本校验,返回成功与否

请求参数

参数名

类型

必填

描述

示例值

jsonStr

String

是

视频配置参数的jsonObject转成的String

{"videoBitrate":1000,"fps":30,"width":800,"height":300,"rcMode":1,"gop":2000,"videoUpper":5000,"videoLower":4000}

JSON参数说明:

编码码率(单位:Mbps):key:bitrate,value ;注意:修改后需要同步设置码率上下限 1~100

编码帧率(单位:fps):key:fps,value:5~60;

编码分辨率 宽:key:width,value;仅校验比例正确

编码分辨率 高:key:height,value ;仅校验比例正确

码率控制模式(ABR/CBR/CAPPED_CRF):key:rcMode,value 0~3, 0 ABR 1 CRF 2 CBR 3 CAPPED_CRF;

编码GOP大小(30~5000):key:gop,value 30~5000;

码率上限(单位:Kbps):key:videoUpper, value ;校验上限>下限 0~100000

码率下限(单位:Kbps):key:videoLower, value ;校验上限>下限 0~100000

调用样例

// 1. 接口
CloudPhoneClient.Callback.AppCallback callback = new CloudPhoneClient.Callback.AppCallback() {
  public static int setCloudVideoConfig(String jsonConfig) {
    return CloudPhoneClientInternal.setCloudVideoConfig(jsonConfig);
  }
};
// 2. 调用
JSONObject videoConfig = new JSONObject();
...
CloudPhoneClient.setCloudVideoConfig(videoConfig.toString());

错误日志

报错参数

描述

bitrate

Failed to set cloud video config, invalid bitrate

fps

Failed to set cloud video config, invalid fps

width, height

Failed to set cloud video config, width and height should be appear in pairs

rcMode

Failed to set cloud video config, invalid rcMode

gop

Failed to set cloud video config, invalid gop

videoUpper, videoLower

Failed to set cloud video config, video upper should larger than lower

videoUpper, videoLower

Failed to set cloud video config, invalid video upper or lower

jsonObject内容错误

Failed to set cloud video config, invalid json format

相关文档