正常开始游戏

开始游戏：

返回状态status=200：数据返回sdk，调用sdk开始游戏

返回状态status=201：开启排队“游戏队列”10秒接口轮询；直至“游戏队列”接口返回200，30秒内必须调用“开始游戏”接口，否则队列将被取消；“游戏队列”返回201继续排队；返回其他则为错误

notify_url参数：事件回调，回调请求参考 ”OPENAPI/存档回调“, 注、需带本次启动id，辨识会话

排队等级：将用户分级，OS后台=》订单=》等级配置，可以限制各等级资源，配置地址：https://os.zhijierongxing.com/web/link_grade.html ；排队测试时，可以设置等级1，最高可使用0%，要出队时再修改成100%；

显示等级：1-5，请查看，游戏中=》切换显示等级的接口

请求参数

Body 参数application/json

channel_id

string

渠道id

必需

string

设备号

必需

每个设备对应一个sn唯一码

client_sid

string

用户标识

必需

string

客户端IP

必需

time

integer

时间戳

必需

sign

string

签名

必需

play_queue_id

integer

排队id

可选

排队成功传递排队id

sc_id

integer

会话id

可选

二次启动必须使用会话id

game_key

string

游戏标识

必需

display_grade

integer

显示等级

必需

1-5 可查看游戏中=》切换显示等级接口

queue_grade

integer

排队等级

必需

1-10，等级越高，优先

able_queue

enum<integer>

是否排队

必需

是否排队 1、是 0、否默认0

枚举值:

model_name

string

设备型号

必需

为了提高游戏体验

cpu

string

设备芯片型号

可选

为了提高游戏体验

save_time

string

加载的存档名称

可选

对应存档列表的version字段

save_from

string

加载的存档来源

可选

空：加载自己的存档；加载他人：指定用户标识

save_enable

integer

是否保存存档

可选

1：是； 0：否默认为1

room_name

string

房间名称

可选

设置相同的，则会分配到同一个房间（排队前后的请求开始游戏的房间名参数请保持一致）尽量房间名有游戏标识如：jy0013-2025062414115792102794349

room_key

string

房间权限控制密码

必需

一个房间使用同一个密码

handle_device

string

控制设备

可选

设置归属玩家的控制设备。包含gp和kb、tc三个属性，其中gp代表手柄的位置，手柄1-4分别用1248表示，比如3代表拥有1号和2号手柄，0代表没有手柄，kb代表键盘位，1是有，0是没有，tc代表触摸，1是有，0是没有。注：room_name字段有设置，则必填

hang_up_timer

integer

挂机时长（秒）

可选

用户设备在游戏过程中突然掉线，在挂机时长内，可支持重连，推荐：300

desk_url

string

游戏启动电脑背景桌面

可选

使用html静态页地址。支持jsCallDeskCppStartGame(path,argc)、jsCallDeskCppReStartGame(path,argc)、jsCallDeskCppStopGame()三个函数调用

enable_restart

integer

是否支持重启游戏

可选

可选, 1为支持，0为不支持，默认为0

game_args

string

游戏启动参数

可选

limit_level

integer

限制资源级

可选

1：高配 2：标配 3：中配 4：低配 0：游戏资源级标配是1660s，高配是3060，4060，2080ti

auto_level

integer

是否自动调节

可选

1：向低资源调节 2：向高资源调节 3：向其他资源调节 0：否；默认否，使用游戏资源级；自动调节则使用小于等于limit_level,无设置limit_level，则小于等于游戏资源级

notify_url

string

事件回调

可选

回调请求参考 ”OPENAPI/存档回调“；注：需带本次启动id，辨识会话

gs_mousemode

integer

GS鼠标模式

可选

用户可以通过此参数来针对游戏进行鼠标模式的配置，可组合使用，0表示自动模式，
1、鼠标移动使用绝对模式
2、鼠标移动使用相对模式
4、鼠标使用软模式（默认使用驱动模式）
8、设置键盘使用模式，8为软码，默认为驱动
16、鼠标右键按下之后鼠标移动使用相对模式的方式（用以Roblox等游戏使用）
32、鼠标按键使用绝对模式（例如全面战争）

示例

{
    "channel_id": "a486828e0524c7f10f4ad56785b64b9",
    "sn": "bea6becab50afccac8db6f5318008dcf",
    "client_sid": "testkey",
    "ip": "36.238.203.74",
    "time": 1731403106,
    "game_key": "jy0013",
    "game_args": "",
    "display_grade": 1,
    "queue_grade": 1,
    "able_queue": 1,
    "save_time": "",
    "save_from": "",
    "save_enable": 1,
    "room_name": "",
    "handle_device":"{\"gp\":5,\"kp\":1}",
    "model_name": "Chrome/121.0.0.0",
    "limit_level": 2,
    "auto_level": 0,
    "sc_id": 0,
    "room_key": "roomKey",
    "enable_restart": "1",
    "hang_up_timer": "300",
    "notify_url": "http://url",
    "sign": "AECE98E58AB99EFF400BA6A0E1E5ED55"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

application/json

Body

status

integer

状态码

必需

200：成功 201：排队中其他为错误

msg

string

消息

必需

data

object

数据

必需

将数据赋值给客户端启动函数

示例

{
    "status": 0,
    "msg": "string",
    "data": {}
}

正常开始游戏

请求参数

示例代码

返回响应