4.1 渲染任务管理
4.1.1 渲染节点调度
功能介绍
一般由设备调用，用于获取可以连接的GPU云服务器的IP地址等信息。
接口约束
无
URI
POST /v1/{project_id}/cvr/node/scheduler 说明
该接口需要使用区域级终端节点调用，例如需进行华北-北京四区域的渲染节点调度，请使用华 北-北京四的终端节点。
表4-1 路径参数
参数 是否
必选
参数类型 描述
project_id 是 String 用户的项目ID。
请求参数
表4-2 请求参数
参数 是否
必选
参数类型 描述
app_id 是 String 设备需要使用的应用ID。
device_id 是 String 设备ID。
● 最小长度：1
● 最大长度：64 device_brand 否 String 设备品牌。
● 最小长度：1
● 最大长度：64 device_type 否 String 设备类型。
device_type的取值范围如下：
● vr：VR头显
● pc：台式机或笔记本电脑
● mobile: 手机或平板
● ideahub: 智慧屏
VR应用默认设备类型为vr，3D应用默认 设备类型为pc。
application_la
unch_args 否 String 应用启动参数。
● 长度范围1到200个字符。
● 只允许输入中文字符、英文大小写字 母、数字、空格、英文引号及“_”、
“-”、“.“、“/”、“:”。
application_us
er 否 String 应用使用用户标识。
● 长度范围1到40个字符。
● 只允许输入英文大小写字母、数字及 下划线“_”。
protocol_type 否 String 设备与云服务器进行通信时所使用的协 议类型。
取值范围如下：
● udp：集成Android VR SDK的客户端 需使用该协议
● webrtc: 集成Windows SDK或
Android 3D SDK的客户端需使用该协 议
● websocket:集成Web SDK的客户端需 使用该协议
默认值：udp。
接口参考 4 API
参数 是否 必选
参数类型 描述
location 否 Array of
strings 区域列表或边缘小站列表。
分配指定区域中的空闲云服务器。
● 最多输入10个区域。
● 每个区域的长度不超过40个字符。
sandbox_enab
le 否 Boolean 该参数已废弃。
是否支持多路会话的云服务器（该参数 仅对VR应用生效）。
● true，表示支持多路会话的云服务 器。此时，在单路会话和多路会话的 云服务器上均可启动渲染任务。
● false，表示不支持多路会话的云服务 器。此时，只能在单路会话的云服务 器上启动渲染任务。
默认值：false。
resolution 否 String GPU云服务器传给设备的画面分辨率
（该参数仅对3D应用生效）。
允许输入480p，540p，720p，1080p，
2k，4k。
默认值：1080p。
gpu_ip_type 否 String 分配给设备使用的GPU云服务器的IP类 型。
● public：表示响应的gpu_ip的IP地址 为公网，适用于使用公网连接设备与 云服务器的场景。
● private: 表示响应的gpu_ip的IP地址 为私网，适用于使用专线或者内网等 连接设备与云服务器的场景。
默认值：public。
响应参数
● 状态码为200时
表4-3 响应 Body 参数
参数 参数类型 描述
gpu_ip String 分配给设备使用的GPU云服务器的IP地址。
link_token String 设备用于连接GPU云服务器的认证凭据。
task_id String 渲染任务的任务ID。
参数 参数类型 描述
port String 云服务器端口。
● 状态码为400时
表4-4 响应 Body 参数
参数 参数类型 描述
error_code String 返回的错误码，如CVR.0001。
error_msg String 错误的英文描述。
请求示例
● 请求URL示例
POST https://{endpoint}/v1/{project_id}/cvr/node/scheduler
● 请求示例
{ "app_id": "5afa7bb2-53d7-11eb-a5aa-fa1640a9b002", "device_id": "477e10fc9938405cb2eceb631a0e6615", "device_brand": "HUAWEI",
"device_type": "pc", "application_user": "user1", "protocol_type": "udp", "location": ["cn-north-1"], "resolution": "480p", "gpu_ip_type": "private"
}
响应示例
● 状态码为200时 OK
{ "gpu_ip" : "255.255.255.255",
"link_token" : "3tkZXZtYW52aWV3X2Rvd25sb2FkX3VybH1111==", "task_id" : "",
"port":"10001"
}
● 状态码为400时
{ "error_code" : "string", "error_msg" : "string"
}
状态码
请参见状态码。
错误码
请参见错误码。
接口参考 4 API