设置云侧视频配置
方法名称
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``} |
| 字段 | 类型 | 说明 |
|---|---|---|
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 的组合支持存在差异。请严格参照下表配置,否则将触发服务端降级策略:
| 芯片平台 | 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,云侧的设置结果将通过该回调响应给端侧。