共享茶室的无人化管理核心在于:当用户下单后,系统需自动授权门禁开启、通电;订单结束后自动断电、关门。芯步的开放接口正好可以解决这一闭环需求。以下方案以“智能包间控制器”为硬件,展示如何通过HTTP接口实现远程指令控制。
1. 背景与选型
在共享茶室(无人值守模式)中,运营的痛点在于:
远程授权:客户下单后,无需前台,通过订单状态自动授权开启门锁。
能源管理:客户离开现场时后,必须切断电源(空调、麻将机、烧水壶等),避免浪费。
环境营造:客户入场时自动亮灯、播放迎宾语音。
硬件选型针对共享茶室/棋牌室场景,芯步提供的 “智能包间控制器(Max/Mini)” 是理想的集成设备。该设备拥有多路继电器输出接口,具体分配如下:
通道 1-3 (10A) :控制照明灯光、换气扇、排风扇。
通道 4-6 (16A) :控制饮水机、麻将机、茶具电磁炉。
通道 7 (门禁专用) :控制电磁锁/电插锁。
通道 8 (30A) :直接控制2匹以内空调(无需额外交流接触器)。
2. 系统设计
整个系统的运行逻辑完全基于 SaaS系统 + IoT平台 + 硬件执行 的闭环。
用户层:微信小程序(用户下单、获取开门权限)。
业务层:共享茶室SaaS系统(处理订单、计算使用时长)。
物联层:芯步开放平台(负责HTTP接口鉴权、设备状态转发)。
感知层:智能包间控制器、人体传感器、门磁锁。
工作流简述用户支付成功 -> SaaS系统通过芯步HTTP接口下发指令 -> 包间控制器第7路给电磁锁断电(开门)+ 第1路开灯 + 第8路开空调 -> 用户进入;订单结束 -> SaaS系统反向指令 -> 关灯、关空调、关门、锁闭电磁锁。
3. 接口集成实施步骤
要实现“远程指令开关控制”,开发者需要重点关注芯步提供的 HTTP API。相比MQTT,HTTP在业务层快速集成上更具优势,无需处理复杂的底层长连接维护。
3.1 准备工作:应用与设备注册
首先在芯步开发者平台创建一个应用,获取 AppId 和 AppSecret。随后在平台添加硬件设备,获取唯一的 Device ID(例如:设备编号 820720)。
3.2 核心接口调试:下发控制指令
芯步的接口设计非常简洁,采用标准的 HTTP POST 请求。你需要在请求头中携带动态生成的签名(Sign)以确保安全性。
接口地址示例http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={timestamp}
请求体结构你需要指定设备ID,并通过 order 对象告诉设备哪个通道做什么。
控制开灯(第1路开启):
*控制门锁(第7路开启/关闭):*共享茶室的门禁通常接在控制器上的“电磁锁”接口。需要注意的是,电磁锁通常需要断电开锁(即通电状态下门锁死,断电后门可开)。但在实际逻辑上,我们通过控制继电器的通断来模拟“开门动作”。
控制空调(第8路):
3.3 高级功能:场景联动
仅靠手动下发指令还不够“智能”。结合芯步的传感器产品,可以实现自动化:
无人自动断电:在包间内安装 “人体存在传感器” 。当订单结束后,系统先不急于断电,而是通过传感器探测。若5分钟内无人移动,则自动触发HTTP指令关闭所有电源。
语音播报:芯步的音柱或带TTS功能的控制器支持文本转语音。当用户开门瞬间,系统可调用语音接口播报:“欢迎光临XX茶室,WIFI密码是12345678,请注意用电安全”。
4. 详细场景流程
为了让你更直观地理解代码逻辑如何转化为实际体验,假设一位名叫“张总”的客户通过小程序预定了晚上7点到9点的“西湖雅间”:
第一种场景:订单开始(远程通电)
时间:18:55。张总到达茶室楼下,点击小程序中的“开门”按钮(或系统自动检测到达距离)。后端处理逻辑
校验订单有效性(已支付、未过期)。
组装JSON数据:
{"device":"包厢控制器ID", "order":{"power7":0, "power1":1, "power8":1, "tts":"欢迎张总,包间已为您准备就绪"}}请求芯步API接口。
硬件反应:门锁“滴”的一声打开,灯光亮起,空调启动,语音播报响起。
状态同步:芯步平台通过消息推送机制,告知SaaS系统“设备已响应成功”。
第二种场景:使用中(环境维持)
时间:19:30。张总出门接电话,门自动关上。潜在风险:如果有人尾随进入怎么办?解决方案:利用芯步的门磁传感器。若检测到门状态变化且非用户主动请求,系统自动调用接口锁定电源输出,并推送告警。
第三种场景:订单结束(远程断电与清算)
时间:21:00。订单即将结束。后端处理逻辑
发送“即将断电”提醒(通过音柱播报)。
5分钟倒计时结束,SaaS系统调用接口:
{"order":{"power1":0, "power8":0, "power4":0}}(关灯、关空调、关茶具电源)。发送指令锁闭门禁:
{"order":{"power7":1}}(继电器吸合,电磁锁上锁)。结果:非管理员无法进入,空调停止运转,实现“人走灯灭电停”。
5. 集成开发中的关键注意事项
在具体实施对接时,以下几点技术细节值得特别留意:
5.1 接口签名机制
为确保安全,每次调用都需要携带签名(Sign)。的生成规则是将 AppId、Device ID、Timestamp 和 Secret 按字典序排序后拼接,再进行MD5加密。不要在微信小程序前端代码中硬编码 AppSecret,应通过自有后端代理请求。
5.2 本地局域网与云端的平衡
芯步支持纯局域网运行。如果茶室网络环境不稳定(例如经常断网),采用 本地局域网推送 模式。在这种情况下,SaaS服务器和硬件设备需处于同一网段,指令响应速度可提升至毫秒级(80-120ms),这对于门禁的快速响应体验至关重要。
5.3 功率负载规划
需要特别提醒:茶室常用的烧水壶功率较大。在接线时,请请一定要将 大功率电器(烧水壶、电磁炉)接到16A通道,将 照明接到10A通道。如果茶室使用的是3匹以上柜机空调,控制器只做信号控制(接空调的应急插孔),不要直接带载,以免烧毁板路。
6. 总结
通过集成芯步 智能包间控制器 的开放接口,开发者可以用简单的HTTP请求实现对共享茶室的 门禁、灯光、空调、插座 的全方位远程控制。该方案不仅降低了布线成本(仅需1台设备替代多个传统继电器),其提供的标准API文档也能让后端工程师在 1-2天内 完成核心功能的联调,是实现共享空间无人化运营的高效路径。