修改游戏内容
概述
为店铺设备动态调整游玩内容。
- 设备状态验证
- 所有设备必须满足：
- 存在且有效
- 属于同一店铺
- 当前处于空闲状态（不正在游戏中，不正在切换游戏中）
- 包名验证
接口地址
http://api.xvista.cc:9999/largespace/public/v1/change/device/game
请求方法
请求参数
url参数：
http://api.xvista.cc:9999/largespace/public/v1/change/device/game?access_token=00000000000000
| 参数 |
必选 |
值 |
| access_token |
是 |
通过Secret Key获取的access_token，参考"获取access_token" |
Body参数：
{
"game" : "com.xx.xx",
"devices" : [{
"sn" : "PA9410MGJ0000000G"
},{
"sn" : "PA9410MGJ0000001G"
}]
}
| 参数 |
必选 |
类型 |
值 |
| game |
是 |
string |
目标游戏包名 |
| devices |
是 |
string-json集合 |
- |
| -sn |
是 |
string |
设备PicoSN |
返回示例
成功返回：
{
"code": 1,
"message": "success",
"data": {
"changeLine": 2
},
"timestamp": 1750076994331,
"executeTime": 137
}
| 参数 |
类型 |
值 |
| changeLine |
int |
修改成功的数量 |
除"data"外的其他参数，可以在“通用说明-统一请求响应”中找到说明
错误返回：
| code |
message |
解释 |
| 400 |
设备总信息异常 |
根据传入信息综合查找的设备信息不正常，检查传入数据 |
| 400 |
包名不存在或数据源异常 |
根据传入信息综合查找的包名信息不正常，检查传入数据 |
| 400 |
设备所属店铺不一致 |
设备所属店铺不一致，检查PicoSN是否正确 |
| 501 |
此时不支持操作，部分设备正在【'游戏中'/'切换中'】 |
设备当前状态不适合开始游戏，先调整设备状态在操作分队，或等待游玩/切换结束 |
| 400 |
设备不存在：【PicoSN】 |
设备PicoSN不存在或不属于当前店铺，检查PicoSN是否正确 |
通用异常可以在“通用说明-统一异常处理”中找到说明
备注