修改设备组队
概述
为店铺设备动态分配游戏分队编号,支持多人/单人游戏模式配置,实现设备分组管理。
- 设备状态验证
- 所有设备必须满足:
- 存在且有效
- 属于同一店铺
- 当前处于空闲状态(不正在游戏中,不正在切换游戏中)
- 分队分配规则
- 新分队号 = 当前最大分队号 + 1 或者 = 不连续空闲分队号
- 原分队关系不影响其他设备(仅修改本次传入的设备)
- 分队号仅影响查询店铺当前所有分队的排序,不影响游玩
- 多人游戏标记
- teamFlag=true时生成多人游戏分队
- teamFlag=false时取消分队进入单人模式
接口地址
http://api.xvista.cc:9999/largespace/public/v1/change/device/team
请求方法
请求参数
url参数:
http://api.xvista.cc:9999/largespace/public/v1/change/device/team?access_token=00000000000000
| 参数 |
必选 |
值 |
| access_token |
是 |
通过Secret Key获取的access_token,参考"获取access_token" |
Body参数:
{
"teamFlag" : true,
"devices" : [{
"sn" : "PA9410MGJ0000001G"
},{
"sn" : "PA9410MGJ0000002G"
}]
}
| 参数 |
必选 |
类型 |
值 |
| teamFlag |
是 |
bool |
是否为多人游戏 |
| devices |
是 |
string-json集合 |
- |
| -sn |
是 |
string |
设备PicoSN |
返回示例
成功返回:
{
"code": 1,
"message": "success",
"data": {
"changeLine": 2
},
"timestamp": 1750076994331,
"executeTime": 137
}
| 参数 |
类型 |
值 |
| changeLine |
int |
修改成功的数量 |
除"data"外的其他参数,可以在“通用说明-统一请求响应”中找到说明
错误返回:
| code |
message |
解释 |
| 400 |
设备总信息异常 |
根据传入信息综合查找的设备信息不正常,检查传入数据 |
| 400 |
设备所属店铺不一致 |
设备所属店铺不一致,检查PicoSN是否正确 |
| 501 |
此时不支持操作,部分设备正在【'游戏中'/'切换中'】 |
设备当前状态不适合开始游戏,先调整设备状态在操作分队,或等待游玩/切换结束 |
| 400 |
设备不存在:【PicoSN】 |
设备PicoSN不存在或不属于当前店铺,检查PicoSN是否正确 |
| 501 |
此时不支持操作,当前分队数量过多 |
逻辑异常现象!自动生成的分队号超过了999,请确认当前店铺是否有1000台以上的设备,否则联系客服调整接口逻辑 |
通用异常可以在“通用说明-统一异常处理”中找到说明
备注