设置显示质量策略v3
更新时间 2026-11-09 14:57:39
最近更新时间: 2026-11-09 14:57:39
接口功能介绍
设置图流模式、图像帧率和画质、视频帧率和画质以及GPU桌面视频帧率。
接口约束
无
URI
POST /v3/strategy/displayQuality
路径参数 无
Query参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionId | 是 | String | 资源池ID。 | xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
请求参数
请求头header参数 无
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| strategyOid | 是 | String | 策略Oid。 | ||
| flowMode | 是 | String | 图流模式。取值： - FLUENCY：优先流畅度。 - ADAPTIVE：自适应。 - IMAGE：优先清晰度。 | ||
| imageMaxFrameRate | 是 | Integer | 图像上限帧率，单位fps。 取值：10、15、20、25、30、 35、40、45、50、55、60。 | ||
| imageMaxFrameRateEnforced | 是 | Boolean | 是否强制执行图像上限帧率。 | ||
| imageQuality | 是 | String | 图像画质。取值： - RGB_24：24位RGB。 - RGBA_32：32位RGBA。 | ||
| videoFrameRate | 是 | Integer | 视频帧率，单位fps。 取值：10、15、20、25、30。 | ||
| videoQuality | 是 | String | 视频画质。取值： - NORMAL：一般。 - GOOD：良好。 - HIGH：优质。 | ||
| gpuDesktopVideoFrameRate | 是 | Integer | GPU桌面视频帧率，单位fps。 取值：25、30、35、40、45、 50、55、60。 |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 状态码，800表示请求成功，900表示请求失败。 | 800 | |
| error | String | 错误码。 | ECPC_1000 | |
| message | String | 提示信息。 | OK. | |
| returnObj | Boolean | 是否设置成功。 |
枚举参数
无
请求示例
请求url
https://{host}?regionId=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
请求头header
无
请求体body
{
"strategyOid":"dsy-xxxxxx",
"flowMode":"ADAPTIVE",
"imageMaxFrameRate":30,
"imageMaxFrameRateEnforced":true,
"imageQuality":"RGB_24",
"videoFrameRate":25,
"videoQuality":"GOOD",
"gpuDesktopVideoFrameRate":30
}
响应示例
{
"statusCode":800,
"message":"OK.",
"returnObj":true
}
状态码
请参考 状态码
错误码
请参考 错误码
