修改设备组队

概述

为店铺设备动态分配游戏分队编号,支持多人/单人游戏模式配置,实现设备分组管理。

  • 设备状态验证
    • 所有设备必须满足:
    • 存在且有效
    • 属于同一店铺
    • 当前处于空闲状态(不正在游戏中,不正在切换游戏中)
  • 分队分配规则
    • 新分队号 = 当前最大分队号 + 1 或者 = 不连续空闲分队号
    • 原分队关系不影响其他设备(仅修改本次传入的设备)
    • 分队号仅影响查询店铺当前所有分队的排序,不影响游玩
  • 多人游戏标记
    • teamFlag=true时生成多人游戏分队
    • teamFlag=false时取消分队进入单人模式

接口地址

http://api.xvista.cc:9999/largespace/public/v1/change/device/team

请求方法

  • POST

请求参数

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台以上的设备,否则联系客服调整接口逻辑

通用异常可以在“通用说明-统一异常处理”中找到说明

备注

  • 暂无
Copyright & www.xvista.cc 2025 all right reserved,powered by Gitbook该文件修订时间: 2025-06-17 03:28:58

results matching ""

    No results matching ""