游戏状态设置为开始
概述
将指定设备组的游戏状态标记为「进行中」，用于启动多人游戏会话或同步设备游戏状态。
- 所有设备必须满足：
- 存在且有效（通过SN校验）
- 属于同一虚拟分队
- 当前处于「待机」状态
接口地址
http://api.xvista.cc:9999/largespace/public/v1/change/device/start
请求方法
请求参数
url参数：
http://api.xvista.cc:9999/largespace/public/v1/change/device/start?access_token=00000000000000
| 参数 |
必选 |
值 |
| access_token |
是 |
通过Secret Key获取的access_token，参考"获取access_token" |
Body参数：
{
"devices" : [{
"sn" : "PA9410MGJ0000000G"
},{
"sn" : "PA9410MGJ0000001G"
}]
}
| 参数 |
必选 |
类型 |
值 |
| devices |
是 |
string-json集合 |
- |
| -sn |
是 |
string |
设备PicoSN |
返回示例
成功返回：
{
"code": 1,
"message": "success",
"data": {
"balance" : 123456,
"changeLine": 2
},
"timestamp": 1750076994331,
"executeTime": 137
}
| 参数 |
类型 |
值 |
| balance |
int |
当前剩余授权点数（不含本次） |
| changeLine |
int |
修改成功的数量 |
除"data"外的其他参数，可以在“通用说明-统一请求响应”中找到说明
错误返回：
| code |
message |
解释 |
| 400 |
设备总信息异常 |
根据传入信息综合查找的设备信息不正常，检查传入数据 |
| 400 |
设备所属店铺不一致 |
设备所属店铺不一致，检查PicoSN是否正确 |
| 501 |
此时不支持操作，部分设备正在【'游戏中'/'切换中'】 |
设备当前状态不适合开始游戏，先调整设备状态在操作分队，或等待游玩/切换结束 |
| 400 |
设备不存在：【PicoSN】 |
设备PicoSN不存在或不属于当前店铺，检查PicoSN是否正确 |
| 501 |
余额不足，操作拒绝 |
余额不满足本次游戏所需，联系客服 |
| 500 |
票量异常 |
解密逻辑出现异常或数据被篡改，联系客服 |
| 500 |
票量解密失败 |
解密逻辑出现异常或数据被篡改，联系客服 |
通用异常可以在“通用说明-统一异常处理”中找到说明
备注