设置节点上云手机帧率和分辨率

接口说明

对指定ID的尊享版节点中云手机进行更换帧率与分辨率操作。接口调用后,等待云手机重启完成即可生效。


推荐使用API Explorer调试

API Explorer支持接口在线可视化调用,同时自动生成动态代码示例,搭配OpenAPI SDK无需计算签名实现接口快速集成。

URL

POST https://ecloud.10086.cn/api/openapi-cloudphone/api/v1/zycloudphone/resource/zh/host/setFpsAndResolution

请求参数

Header

参数名称
类型
必填
描述
pool
string
是

资源池ID

Body

参数名称
类型
必填
描述
req
OpenapiSetFpsAndResolutionReq
是

req

fps
integer(int32)
是

帧率-fps

hostIds
<string> array
是

节点ID列表

resolution
integer(int32)
是

分辨率

请求示例

POST https://ecloud.10086.cn/api/openapi-cloudphone/api/v1/zycloudphone/resource/zh/host/setFpsAndResolution
{
	"hostIds":[
		"1811707545332031490"
	],
	"fps":60,
	"resolution":1080
}

返回参数

返回码:200
OK
参数名称
类型
描述
body
<CloudPhoneJobDto> array

响应体

beginTime
string(date-time)

任务处理开始时间

content
string

任务内容

endTime
string(date-time)

任务处理结束时间

errorCode
string

任务错误码

errorMsg
string

任务错误码说明

executeMsg
string

任务执行返回内容

jobId
string

任务ID

phoneId
string

云手机ID

phoneName
string

云手机名称

status
integer(int32)

状态:1 :运行中, 2 : 成功,-1 :失败

traceId
string

链路id

type
integer(int32)

任务类型(更新中):1:开机、2:关机、3:重启、4:初始化、5:更换镜像、6:安装应用、7:卸载应用、8:执行shell命令、9:执行shell异步命令、10:推送文件、11:备份、12:恢复、13:绑定云硬盘、14:解绑云硬盘、15:更新云手机属性、16:三合一重置、17:三合一重启、18:重启并重置、19:备份,无pod、20:修改机型设备属性、21:截图、22:推送文件到指定位置、23:更换机型、24:异步应用列表、25:订购、26:退订、27:冻结、28:恢复、29:移入回收站、30:从回收站恢复、31:租户回收分配出去的云手机、32:设置云机互踢属性、33:云机拷贝、34:设置云机应用黑名单、36、ADB密钥绑定、37、智能调度-更换节点

errorCode
string

错误编码

errorMessage
string

错误信息

requestId
string

请求id

state
string

状态值

返回示例

返回码:200
OK
{
	"errorCode":"00000000",
	"errorMessage":"请求成功",
	"requestId":"5055fb0f-d19c-420c-884c-5215aff61140",
	"state":"OK",
	"body":[
		{
			"phoneId":"1990335996148924418",
			"phoneName":null,
			"jobId":"1991783128676933634",
			"beginTime":"2025-11-21 16:17:58",
			"endTime":null,
			"status":2,
			"type":43,
			"errorCode":null,
			"errorMsg":null,
			"executeMsg":null,
			"content":"pod-5zzb-f361bf105bdd4031b82c91754c237662",
			"traceId":"5055fb0f-d19c-420c-884c-5215aff61140"
		}
	]
}
本文档内容整理自移动云官方帮助中心(查看原文),仅供参考。