CATALOG

共享茶室的无人化管理核心在于:当用户下单后,系统需自动授权门禁开启、通电;订单结束后自动断电、关门。芯步的开放接口正好可以解决这一闭环需求。以下方案以“智能包间控制器”为硬件,展示如何通过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 准备工作:应用与设备注册

首先在芯步开发者平台创建一个应用,获取 AppIdAppSecret。随后在平台添加硬件设备,获取唯一的 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。张总到达茶室楼下,点击小程序中的“开门”按钮(或系统自动检测到达距离)。后端处理逻辑

  1. 校验订单有效性(已支付、未过期)。

  2. 组装JSON数据:{"device":"包厢控制器ID", "order":{"power7":0, "power1":1, "power8":1, "tts":"欢迎张总,包间已为您准备就绪"}}

  3. 请求芯步API接口

  4. 硬件反应:门锁“滴”的一声打开,灯光亮起,空调启动,语音播报响起。

  5. 状态同步:芯步平台通过消息推送机制,告知SaaS系统“设备已响应成功”。

第二种场景:使用中(环境维持)

时间:19:30。张总出门接电话,门自动关上。潜在风险:如果有人尾随进入怎么办?解决方案:利用芯步的门磁传感器。若检测到门状态变化且非用户主动请求,系统自动调用接口锁定电源输出,并推送告警。

第三种场景:订单结束(远程断电与清算)

时间:21:00。订单即将结束。后端处理逻辑

  1. 发送“即将断电”提醒(通过音柱播报)。

  2. 5分钟倒计时结束,SaaS系统调用接口:{"order":{"power1":0, "power8":0, "power4":0}}(关灯、关空调、关茶具电源)。

  3. 发送指令锁闭门禁:{"order":{"power7":1}}(继电器吸合,电磁锁上锁)。

  4. 结果:非管理员无法进入,空调停止运转,实现“人走灯灭电停”。

5. 集成开发中的关键注意事项

在具体实施对接时,以下几点技术细节值得特别留意:

5.1 接口签名机制

为确保安全,每次调用都需要携带签名(Sign)。的生成规则是将 AppIdDevice IDTimestampSecret 按字典序排序后拼接,再进行MD5加密。不要在微信小程序前端代码中硬编码 AppSecret,应通过自有后端代理请求。

5.2 本地局域网与云端的平衡

芯步支持纯局域网运行。如果茶室网络环境不稳定(例如经常断网),采用 本地局域网推送 模式。在这种情况下,SaaS服务器和硬件设备需处于同一网段,指令响应速度可提升至毫秒级(80-120ms),这对于门禁的快速响应体验至关重要。

5.3 功率负载规划

需要特别提醒:茶室常用的烧水壶功率较大。在接线时,请请一定要将 大功率电器(烧水壶、电磁炉)接到16A通道,将 照明接到10A通道。如果茶室使用的是3匹以上柜机空调,控制器只做信号控制(接空调的应急插孔),不要直接带载,以免烧毁板路

6. 总结

通过集成芯步 智能包间控制器 的开放接口,开发者可以用简单的HTTP请求实现对共享茶室的 门禁、灯光、空调、插座 的全方位远程控制。该方案不仅降低了布线成本(仅需1台设备替代多个传统继电器),其提供的标准API文档也能让后端工程师在 1-2天内 完成核心功能的联调,是实现共享空间无人化运营的高效路径。