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

设置云侧视频配置

方法名称

int setCloudVideoConfig(String jsonConfig)

功能描述

设置云侧视频配置。该方法用于配置云机的视频编码参数,如码率、帧率、分辨率等,以优化视频传输质量。

参数说明

字段名

类型

说明

jsonConfig

String

配置项JSON字符串,格式如下:{`` "bitrate": 50,`` "fps": 60,`` "width": 720,`` "height": 1080,`` "rcMode": 0,`` "gop": 3000,`` "videoUpper": 50000,`` "videoLower": 20000,``"frameType": H264,`` "encoderPlugin": VDO``}

表1 JSON配置字段说明

字段

类型

说明

bitrate

int

目标码率(单位:Mbps)

fps

int

目标帧率(帧/秒)

width / height

int

视频分辨率(宽/高)

rcMode

int

码率控制模式(如 0: CBR, 1: VBR,以实际协议为准)

gop

int

GOP 大小(关键帧间隔)

videoUpper / videoLower

int

码率上限/下限(单位通常与 bitrate 对齐,如 Kbps)

frameType

String

视频编码格式,支持 "H264" 或 "H265"

encoderPlugin

String

硬件编码插件,支持 "VDO" 或 "VDC"

编码格式与插件兼容性说明

不同芯片平台对 frameType 与 encoderPlugin 的组合支持存在差异。请严格参照下表配置,否则将触发服务端降级策略:

表2

芯片平台

encoderPlugin

支持的 frameType

RX3 (A11)

VDO

H264, H265

VDC

H264

RX7 (A14)

VDO

H264, H265

VDC

H264, H265

⚠️ 降级处理机制

由于不同芯片平台对编码格式与插件的组合支持有限,若客户端传入不支持的组合(如 RX3 平台配置 VDC + H265),服务端将自动对 encoderPlugin 进行降级处理(如切换至兼容的 VDO 插件),以确保不中断串流状态,最终实际生效的配置将通过回调接口响应给端侧。

返回值

int,成功返回0,失败返回1。

调用示例

String config = "{\"bitrate\":50,\"fps\":60,\"width\":720,\"height\":1280,\"rcMode\":0,\"gop\":3000,\"videoUpper\":50000,\"videoLower\":20000,\"frameType\":H264,\"encoderPlugin\":VDO}";
int result = CloudPhoneClient.setCloudVideoConfig(config);

关联回调:onDynamicConfigNotify,云侧的设置结果将通过该回调响应给端侧。

相关文档