# 设置云侧视频配置
#### 方法名称
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\`\`} |
   
表1JSON配置字段说明 
| 字段  | 类型      | 说明                                  |
|:---|:---|:---|
| ``` 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  |
| **RX3 (A11)**   | ``` VDC ```                             | H264         |
| **RX7 (A14)**  | ``` VDO ```                             | H264, H265  |
| **RX7 (A14)**  | ``` VDC ```                             | H264, H265   |
   
![](https://support.huaweicloud.com/sdkreference-koophone/public_sys-resources/caution_3.0-zh-cn.png)
**⚠️ 降级处理机制**
由于不同芯片平台对编码格式与插件的组合支持有限，若客户端传入**不支持的组合** （如 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，**云侧的设置结果将通过该回调响应给端侧。