凯发k8国际娱乐官网入口-k8凯发> vr云渲游平台 cvr> > > > 渲染节点调度
更新时间：2021-11-25 gmt 08:00

渲染节点调度-凯发k8国际娱乐官网入口

功能介绍

一般由设备调用，用于获取可以连接的gpu云服务器的ip地址等信息。

接口约束

无

uri

post /v1/{project_id}/cvr/node/scheduler

该接口需要使用区域级终端节点调用，例如需进行华北-北京四区域的渲染节点调度，请使用华北-北京四的终端节点。

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

string

用户的项目id。

请求参数

表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_launch_args

否

string

应用启动参数。

  • 长度范围1到200个字符。
  • 只允许输入中文字符、英文大小写字母、数字、空格、英文引号及“_”、“-”、“.“、“/”、“:”。

application_user

否

string

应用使用用户标识。

  • 长度范围1到40个字符。
  • 只允许输入英文大小写字母、数字及下划线“_”。

protocol_type

否

string

设备与云服务器进行通信时所使用的协议类型。

取值范围如下：

  • udp：集成android vr sdk的客户端需使用该协议
  • webrtc: 集成windows sdk或android 3d sdk的客户端需使用该协议
  • websocket:集成web sdk的客户端需使用该协议

默认值：udp。

location

否

array of strings

区域列表或边缘小站列表。

分配指定区域中的空闲云服务器。

  • 最多输入10个区域。
  • 每个区域的长度不超过40个字符。

sandbox_enable

否

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时
    表3 响应body参数

    参数

    参数类型

    描述

    gpu_ip

    string

    分配给设备使用的gpu云服务器的ip地址。

    link_token

    string

    设备用于连接gpu云服务器的认证凭据。

    task_id

    string

    渲染任务的任务id。

    port

    string

    云服务器端口。
  • 状态码为400时
    表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" 
}

状态码

请参见。

错误码

请参见。

父主题：
分享：
网站地图