芯步智能包间控制器Max TTS版集成了8路电器控制与语音播报功能,通过开放的HTTP API,开发者可将麻将机等设备快速接入现有管理系统。以下方案涵盖硬件选型、接口调用、核心代码及典型场景配置。
解决方案:基于芯步开放接口的智能包间电源控制(含麻将机控制与TTS语音联动)
1. 概述
本方案基于芯步的 智能包间控制器 Max TTS版(产品型号:UNI-KZQ-BJ-MAX-TTS),利用其开放的 HTTP API 接口,将传统麻将机接入物联网系统。
该方案不仅能实现用户扫码/远程开关麻将机电源,还能结合 TTS(Text To Speech,文本转语音)功能,在订单开始、结束或异常时自动播报语音提示,实现完全的无人化、智能化棋牌室管理。
| 功能模块 | 实现的方式是 | 用户/管理者体验 |
|---|---|---|
| 硬件核心 | 智能包间控制器 Max TTS版(8路输出 + 语音播报) | 一台设备集成麻将机、空调、灯光、门锁的全部控制 |
| 控制协议 | HTTP API / 微信小程序 / 任何支持HTTP的编程语言 | 无需专用网关,WiFi直连,支持局域网和公网双模式 |
| 核心逻辑 | 通断第4/5/6路(16A继电器) + 调用TTS语音命令 | 远程通电自动上电,自动语音播报(如“欢迎光临,麻将机已通电”) |
2. 硬件选型与接线方案
针对麻将机控制,我们需要关注控制器的负载能力。麻将机电机属于感性负载,启动瞬间电流较大。
推荐设备智能包间控制器 Max TTS版
接口分配
第4/5/6路:专用于麻将机、饮水机、按摩椅。该接口支持 16A 额定电流,最大可带 3500W 阻性负载或 500W 感性负载,足以覆盖市面上绝大多数家用/商用麻将机的峰值功率。
第8路:用于2匹空调(30A继电器)。
第1-3路:用于照明、排风扇。
第7路:用于门锁控制。
接线操作指引
断电操作:请一定要关闭总闸。
接入麻将机:将麻将机的电源插头插入控制器的 “接口4”(或其他指定的16A接口)。
接入语音:设备内置TTS模块,无需额外接线,只需确保设备连接网络即可。
3. 开放接口对接详解
芯步的接口采用标准的 HTTP 协议,签名算法简单,适合快速开发。
3.1 接口鉴权与基础信息
请求地址
https://api.thingboot.com/{AppId}/device/control/请求方法:POST
核心Header
Content-Type: application/json
签名生成规则(以控制麻将机插座为例)你需要引入 AppId 和 AppSecret。签名生成规则涉及 MD5 运算,以下是生成 sign 的计算逻辑伪代码:
注意:实际开发中请参考芯步官方 SDK 进行签名计算。
3.2 核心 API 指令详解
以下是针对“麻将机”场景最常用的两个指令,以 Python requests 库为例。
第一种场景:远程开启麻将机电源假设麻将机接在控制器的 第4路(对应参数 power4),且设备ID为 your_device_id_123。
第二种场景:让TTS音箱播报语音当用户下单成功后,系统自动触发语音提醒,告知顾客麻将机已通电。
4. 典型业务流程设计
为了实现“自动麻将机电源控制”,在您的 SaaS 或小程序后台配置以下逻辑:
用户下单支付成功
动作1:调用
power4=1(给麻将机通电)。动作2:延迟1秒调用
play播报:“订单已生效,麻将机已通电,祝您旗开得胜”。动作3:调用
power1=1打开主照明灯。
用户点击“退单/结束”按钮
动作1:调取门锁状态,确认无人后,调用
power4=0(麻将机断电)。动作2:调用
power1=0关闭灯光。
超时未续费自动处理
动作1:调用
power4=0(强制断电,防止蹭玩)。动作2:调用 TTS 高音量播报:“时间已到,即将断电,请收拾物品准备离开现场时”。
5. 高级特性和需要注意的点
局域网直连(私有化)芯步设备支持纯局域网环境通信。如果你的棋牌室网络不稳定或要求极低延迟,可以将 API 请求地址指向设备所在的局域网 IP,这样即使外网断开,依然可以控制麻将机和语音播报。
关于感性负载麻将机电机在断电瞬间会产生反向电动势。虽然 Max 版本的继电器已有保护,但在多台麻将机高频率开关场景下,检查控制柜是否安装阻容吸收回路,以延长设备寿命。
批量控制如果有连包(联通包间),可以使用
batch命令实现“一键开场”或“一键清场”。
总结
通过接入芯步 智能包间控制器 Max TTS版,开发者可以在 3 小时内 完成从注册到麻将机控制及语音播报的全流程对接。该方案不仅解决了麻将机等大功率设备的远程通断问题,还利用 TTS 语音补全了无人值守场景下的服务交互闭环。