CATALOG

共享棋牌室的智能化核心在于:用户侧要“摸得到”(本地触控),商户侧要“管得到”(远程控制)。以下方案基于芯步开放接口,从硬件选型、接口调用、双控逻辑三个层面展开,可直接用于技术方案设计。

1. 概述与设计目标

在共享棋牌室的运营中,顾客的核心诉求是“操作便捷、即刻使用”,而商家的核心诉求是“降低运维成本、集中管控”。本方案的目标是利用芯步的智能硬件与开放 API,解决传统包间内电器控制分散、依赖人工巡检的问题。

  • 实现本地触摸控制:顾客进入包间后,通过墙上的触摸面板直接控制灯光、麻将机、空调,无需寻找遥控器或手机。

  • 实现远程与自动化控制:商家后台或用户手机小程序实现远程关电、门禁解锁;订单结束时自动全屋断电,防止浪费。

  • 统一控制核心:采用“智能包间控制器”作为包间内的核心大脑,统一管理强电线路。

2. 硬件选型与拓扑结构

为实现上述目标,硬件选型需遵循“强弱电分离、集中控制”的原则。

2.1 核心设备选型

根据芯步产品线,选用以下核心设备:

  1. 智能包间控制器 (推荐 Max 版或 Mini 版)

    • 角色:包间内所有电器的中枢神经。

    • 接口能力:提供多达 8 路(Max版)独立继电器输出。例如:1路接照明、1路接麻将机、1路接空调、1路接门禁锁。每一路均可通过 HTTP/MQTT 协议独立控制通断

    • 语音能力:TTS版本支持远程语音播报,可提醒顾客“订单即将结束”或“欢迎光临”

  2. 本地触摸面板

    • 方案A智能墙壁触摸开关。通过芯步的 WiFi 触摸开关直接接入网络,用户按压物理按键触发继电器翻转,同时状态同步至云端(可作为本地备用控制)

    • 方案B自研工业触摸屏。通过 HTTP 接口调用控制包间控制器。对于共享棋牌室而言,方案A(智能墙壁开关) 成本更低且符合用户习惯。

  3. 门禁硬件

    • 采用 磁力锁/电插锁 + 出门开关。接入包间控制器上的门禁接口(或独立门禁控制器),支持远程开门(商家后台点击“开锁”)和本地按钮开门

2.2 网络拓扑图设计

  • 控制层:商户后台(SaaS)<--> 芯步云平台 <--> 路由器(WiFi/4G) <--> 包间控制器 & 触摸开关。

  • 设备层:包间控制器(继电器输出)--> 强电线路 --> 灯光/麻将机/空调。

  • 用户层:微信小程序(扫码下单) <--> 云端API <--> 设备联动。

3. 系统实现:双控制逻辑与接口集成

本方案的核心在于利用芯步开放的 HTTP API 接口,串联起用户的触控操作与商户的远程指令。

3.1 接口对接基础(签名与鉴权)

在调用任何控制指令前,需在后端完成 SDK 集成。芯步接口采用动态签名鉴权:

  • 核心参数AppID(应用ID)、AppSecret(密钥)、ts(时间戳)。

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

  • 请求地址http(s)://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

3.2 实现“本地触摸控制”

场景:顾客按下墙面上的“麻将机”按钮。

  • 技术路径:智能触摸开关(如芯步2路墙壁开关)在被按压时,其状态会通过 WiFi 上报至芯步云平台

  • 联动逻辑:芯步云平台利用“场景联动”功能或通过向开发者的服务器推送设备状态变更的消息,触发预设规则:

    • 如果开关的 power1 状态变为 1(开启),则云端向“智能包间控制器”下发指令。

    • 指令示例{"device":"包间控制器ID", "order":{"power2":"1"}} (开启麻将机对应的继电器2)

  • 结论:本地触摸控制实际上是“本地触控 -> 云端逻辑 -> 设备执行”的闭环,延迟控制在 100ms 以内,用户几乎无感知。

3.3 实现“远程双控”(商家后台与小程序)

场景:顾客在小程序下单购买“2小时套餐”,支付成功后系统自动通电;或商家后台强制关闭某房间空调。

第一步:远程解锁门禁当用户下单时,后台调用 OpenAPI 远程解锁门锁。

  • Python 调用示例(参考芯步文档)

第二步:用户端远程自控用户在小程序点击“开灯”。

  • HTTP 请求报文

    引用自接口文档及博客实现

第三步:商家远程巡检与时段控制

  • 商家后台可定时轮询设备状态,或利用 MQTT 推送 接收设备离线告警。

  • 订单超时未续费,系统自动调用:{"order":{"batch":{"relay":[1,2,3,4,5,6],"power":0}}} (批量关闭所有电器),实现“人去电断”

3.4 订单结束的“软控制”优化

对于空调等设备,直接断电会损伤压缩机。利用芯步的 “先断后通”或“延时控制” 指令优化流程:

  • 流程:订单结束前15分钟,TTS语音播报提醒

  • 执行:先发送红外/逻辑关机指令(或仅关闭风机),5分钟后发送 {"order":{"power8":"0"}} 切断空调总电源。

4. 关键实施步骤和需要注意的点

4.1 实施步骤

  1. 环境搭建:注册芯步开发者账号,创建应用获取 AppID/Secret。

  2. 设备配网:使用“物联网控制台”或 SDk 将智能包间控制器和触摸开关连接至 2.4G WiFi

  3. 接口联调

    • 调用 /device/control/ 接口测试单路继电器通断。

    • 订阅设备状态变更的异步消息(用于同步本地按键状态)。

  4. 业务封装:将 /device/control/ 接口封装进你的小程序后端,对外暴露 openLight(room_id) 等业务接口。

4.2 避坑指南与

  1. 强电安全:芯步的包间控制器虽然支持 6600W 总额定功率(30A接口),但安装时必须由专业电工操作,确保空调、麻将机等大功率设备接入对应的 16A/30A 接口,严禁小继电器带大负载

  2. 网络冗余:虽然设备支持 WiFi,但在商业环境中为每个包间单独预留企业级 AP,或选用带 4G 备份的网关,防止路由器死机导致“用户有网但设备离线”的尴尬

  3. 状态同步机制:由于存在双控(触摸开关直接控制 + 手机远程控制),请一定要依赖云端的状态同步。使用 MQTT 长连接 保持前端页面的实时状态更新,防止用户 APP 显示“关”,但实际灯亮着

5. 总结

通过接入芯步的 智能包间控制器开放 API,开发者可以快速构建一套“软硬一体”的共享棋牌室系统。

  • 技术上:利用标准的 HTTP 请求即可实现对强电设备的物理级控制,开发门槛低,一周内即可完成对接。

  • 体验上:既保留了传统物理开关的直觉操作,又通过云端实现了无人值守的远程管理与自动化场景(如断电、催单),完美契合 24 小时共享经济的需求。