CATALOG

共享棋牌室的痛点是“人效”——传统模式下,商家需要夜间值守、人工巡检电源、手动处理超时。芯步的8路智能分体控制箱正好切中这个需求:它提供8路独立继电器输出,通过开放HTTP API即可与小程序、SaaS系统打通,实现自助开灯通电、计时结束自动断电的全流程自动化。

以下是具体的技术对接方案:

共享棋牌室设备电源控制解决方案

一、 硬件选型与场景定义

在共享棋牌室场景中,通常一个包间内需要控制的设备包括:照明灯、麻将机、空调、排风扇、路由器以及可能存在的茶水机

芯步 智能分体控制箱 (8路) 是最佳选择。该设备具备以下特性:

  • 多路独立控制:支持8路继电器输出,每一路均可独立控制通断。

  • 负载能力强:单路阻性负载可达2200W,足以覆盖麻将机和空调的启动需求。

  • 网络接入:支持WiFi (2.4GHz) 或以太网接入,部署在网络较好的棋牌室吊顶或弱电箱内。

接线规划示例:

通道 (Port)连接设备控制逻辑备注
第1路照明按订单通电/断电进房自动亮,离房灭
第2路麻将机按订单通电/断电核心设备
第3路空调按订单通电/断电夏季/冬季必备
第4路排风扇延时断电结束后抽风30分钟除味
第5路路由器/交换机常通 (不进控制)或独立供电,保证信号
............

二、 软件集成架构

芯步的开放接口采用标准的 HTTP APIMQTT 协议,这意味着无论你的软件后台是用Java、Python、PHP还是Go开发的,均可无缝对接

接口调用核心流程:

  1. 设备激活:控制箱上电后会自动连接云端。

  2. 业务绑定:在芯步控制台或调用API,将设备ID与你的业务系统中的“房间ID”进行绑定。

  3. 指令下发:用户在小程序下单,业务后台向芯步云端发起HTTP请求,控制物理继电器开合。

三、 业务对接开发指南

1. 准备工作与鉴权

在对接前,你需要在芯步开放平台获取密钥用于身份验证。

  • AppID:应用唯一标识。

  • AppSecret:应用密钥,用于计算签名。

  • 签名算法sign = md5(md5(AppSecret) + ts)

  • 全局域名api.thingboot.com

关键点:所有接口请求都需要在URL中携带 signts(时间戳),防止接口被恶意篡改。

2. 关键接口实现

第一种场景:用户下单支付成功(自动通电)当用户在共享小程序上扫码付费,系统创建订单成功后,需要自动为该房间通电。

  • 需求:需要控制具体的某一个端口(例如第2路麻将机)。

  • 接口地址https://api.thingboot.com/{AppID}/device/control/

  • 请求方法:POST (JSON格式)

  • 请求参数

  • 编程逻辑:用户支付成功 -> 调用此接口 -> 返回 {“code”:200} -> 设备通电。

第二种场景:订单结束或超时(自动断电)用户点击退房,或计费时间结束(计时器归零)时,系统需要切断所有设备电源,防止盗用。

  • 需求:关闭该设备的所有8路端口。

  • 接口参数

第三种场景:紧急情况或保洁辅助控制保洁打扫卫生需要通电,但用户不在线;或者遇到火灾报警需要远程切电。这可以通过管理后台的按钮来完成。

3. 高级功能:状态同步与异步消息

为了避免“指令发出去了,但设备没反应”的情况,接入 MQTT推送状态查询接口

  • 状态反馈:当继电器真的吸合或断开时,云端会向你的服务器推送一条消息。

  • 应用:如果你的UI需要实时显示“设备已开启”或“设备离线”状态,不能仅依赖HTTP请求的200返回码(200仅代表指令平台收到了,不代表设备执行了),必须订阅设备状态变更的异步消息

  • 心跳机制:根据共享棋牌的专利技术,控制器应定时发送心跳包。你的系统应监测设备最后心跳时间,若超过阈值(如5分钟),则在后台标记“设备离线”,禁止用户下单

四、 无人值守逻辑优化

结合8路控制箱的特性,可以在标准自助流程上增加以下优化:

  1. 分路计费逻辑(可选)有些共享棋牌室实行“照明免费,麻将机收费”。这种情况下,你可以在接口中仅控制 power2(麻将机)进行计费,而 power1(照明)则在用户下单后自动开启,不计入能耗统计

  2. “续费”不停机当用户即将超时,在小程序点击“续费”时,系统不要发送断电指令。如果在超时瞬间断电,麻将机会立刻停止工作,用户体验差。逻辑是:时间归零 -> 立即切电;续费成功 -> 立即按原样恢复通电。API指令需要精确到单路控制。

  3. 场景联动(防尴尬设计)

    • 有人传感器联动:如果接入了人体传感器,在订单结束后,若检测到房间内无人,再执行断电。防止用户还在收拾东西突然黑灯。

    • 定时任务:芯步设备支持云端定时。可以设置每天晚上11点自动切断所有未关机的房间电源,进行系统巡检

五、 对接测试步骤

  1. 硬件就绪:将8路控制箱通电,接入Wi-Fi,在芯步后台查看设备状态是否为“在线”。

  2. 接口调试:使用Postman工具,填入正确的AppID和计算出的Sign,手动向设备发送 {“power1”:1},观察继电器是否“咔”一声吸合。

  3. 代码集成:将上述API封装成你的后端服务 PowerService.phpPowerController.java

  4. 联调:打开小程序 -> 模拟下单 -> 数据库生成订单 -> 调用服务层API -> 灯亮。

六、 负载安全注意事项

在实施接线时,必须严格注意8路控制箱的总负载限制 4400W

  • 空调外机/内机:虽然设备支持,但空调这类大功率设备(特别是老式柜机)不要直接接入,而是通过控制箱控制交流接触器,由接触器去带动空调。这样可以延长控制箱继电器的寿命。

  • 照明:如果是LED灯带,属于感性负载,功率需打折扣(不超过350W/路)

总结一下

通过接入芯步8路智能分体控制箱的API接口,你的共享棋牌室软件项目能够以极低的开发成本(仅需调用几个HTTP接口)实现硬件的远程控制。这不仅实现了“一键开店、自动断电”的无人值守模式,还能通过精细化的电源管理(分路控制、能耗监测)降低运营成本,提升智能化管理水平。