共享棋牌室的远程控制痛点在于:无人值守时设备未及时关闭造成浪费,以及手动巡场增加人力成本。基于芯步智能硬件(特别是包间控制器)的HTTP开放接口,可通过定时任务机制实现订单结束自动断电、预约时段自动通电、空闲时段批量巡检等场景。
解决方案:基于芯步开放接口的共享棋牌室定时任务与远程控制系统
1. 概述与选型
在共享棋牌室场景中,核心需求是实现对包间内麻将机、空调、照明、门禁的自动化管理。
本方案采用芯步“智能包间控制器”系列作为硬件。该设备支持7-8路独立继电器控制,可覆盖包间内所有电器,且直接支持HTTP接口调用和远程定时任务。
硬件选型:
主选设备: 芯步 智能包间控制器 | Max (具备8路输出,支持30A空调接口)。
传感器补充(可选): 智能人体存在传感器(用于检测包间是否有人,辅助节能)。
架构逻辑:
graph LR
User[用户端/管理员] --> Applet[微信小程序/管理后台]
Applet --> Cloud[芯步云端 API]
Cloud --> Controller[包间控制器
硬件设备]
Controller --> Device1[麻将机]
Controller --> Device2[空调/灯光]
Controller --> Device3[门禁]2. 硬件接入与接口准备
在开发定时任务之前,需完成设备的网络配置与接口对接。
接口协议: 设备使用 HTTP/HTTPS 协议通信。
控制粒度: 可独立控制每一路继电器的通断(
power1至power8),并支持语音播报(TTS)。基础配置步骤:
设备上电,通过配网模式让其连接到Wi-Fi(2.4G)。
在芯步开发者后台获取
AppId和AppSecret。获取目标设备的
Device ID。
3. 定时任务核心逻辑实现
本方案的核心在于如何在业务服务器上构建定时任务调度系统,控制硬件状态。
关键命令示例(HTTP POST):
三种典型的定时任务模式:
订单关联式定时(精确时间点)
场景: 用户在小程序下单购买了2小时。
逻辑:
开锁/通电: 支付成功瞬间,服务端立即向控制器发送
{"power7":"1"}(门禁开)和{"power1":"1"}(麻将机通电)。预提醒(定时): 订单结束前5分钟,调用
order携带TTS语音播报命令,提醒用户续费。断电(定时): 订单结束时间到,服务端发送批量关闭命令
{"batch":{"relay":[1,2,3,4,5,6],"power":0}},并发送门禁锁指令{"power7":"0"}。
循环周期式定时(维护与节能)
场景: 深夜时段强制关闭总电,防止偷电或资源浪费;清晨定时开启排风换气。
逻辑:
在管理后台设置Cron任务(如:
0 2 * * *)。凌晨2点,系统扫描所有未关机的包间,强制执行全关指令
{"power_all":"0"},并在2:05执行排风扇开启{"power2":"1"},2:35关闭排风扇。
联动式触发(事件驱动)
场景: 用户结束订单离店后,系统自动巡检。
逻辑:
订单结束后,利用人体存在传感器检测包间内是否还有人移动。
判定逻辑:若订单结束10分钟后,传感器状态为“无人”,则强制拉闸断电;若为“有人”,则向管理员告警,避免误伤。
4. 开发实施步骤
第一步:服务器端搭建利用芯步开放的API,在您的云服务器上开发业务逻辑。
签名计算:每次请求需携带
sign参数。通常算法为md5(AppId + AppSecret + Timestamp)。请请一定要在服务器端完成签名计算,避免在前端暴露AppSecret。状态同步:服务器需监听设备的上行消息推送(如设备上下线、传感器触发)。配置消息推送URL(Webhook),以便实时获取设备状态变化。
第二步:用户体验端(小程序/App)集成在小程序端调用云函数或直接调用HTTP接口。
核心功能:展示包间设备状态图标,提供“一键全开/全关”按钮。
重要提示:所有涉及电路通断的操作,在UI上增加二次确认弹窗,避免用户误触导致麻将机数据丢失(突然断电可能损坏麻将机主板,:先通过语音播报提醒,延时5秒后再执行断电)。
第三步:安全与可靠性保障
断线重连:智能包间控制器本身具备重连机制,只要WiFi恢复,设备会自动重连云端。
本地联动(可选):若对网络依赖性要求比较高,可考虑芯步支持的“局域网”或“私有化”部署方案,保证在公网断网时,内网服务器仍可控制设备。
指令执行反馈:设置超时重试机制。若发送
power1=0后未收到成功回执,服务端应在间隔500ms后重试2-3次。
5. 总结
开发友好:基于标准HTTP协议,任何后端语言均可快速集成,无需关心底层MQTT协议细节。
多路独立:8路独立控制,彻底解决共享棋牌室“只想关灯不想关空调”的精细化控制需求。
高性价比:集成语音播报功能,可直接替代独立的叫铃或提醒喇叭,降低硬件成本。