共享茶室的痛点是“静”——客人静坐品茶时,普通红外传感器会误判无人而关灯断电,体验极差。芯步的壁挂式双模传感器(红外+雷达)正好解决这个问题,通过HTTP接口对接,可实现“人在灯亮、人走断电”的无感控制。
解决方案:基于芯步双模感应器的共享茶室人体存在感知集成方案
1. 行业痛点与解决概述
1.1 共享茶室的特殊挑战共享茶室属于高隐私、高自主性空间,且存在大量“静坐”场景(品茶、洽谈)。传统基于PIR(被动红外)的人体传感器极易在此类场景下误判,导致正在消费的客户遭遇突然断电断网,严重影响体验。1.2 方案优势利用芯步 UNI-CGQ-RT-H-BG 壁挂式智能双模人体感应器(红外+雷达),通过其开放的HTTP API接口,实现对茶室内人体存在(不仅仅是移动)的精准感知。当检测到有人时,自动通电;当确认真无人时,自动执行断电结算或节能操作。
2. 硬件核心特性(为什么选这款传感器)
在对接前,需要理解该硬件的独特逻辑,这对后续业务逻辑设计至关重要:
| 特性 | 参数/描述 | 商业价值 |
|---|---|---|
| 探测机制 | 红外+雷达双重确认:需两者均判定无人,才输出“无人”信号。 | 解决静坐时红外失效导致的误断电问题。 |
| 负载输出 | 自带 1路 AC交流输出(可直接控制220V电路)。 | 可直接切断/接通茶室总电源或茶桌插座。 |
| 上报机制 | 状态变化实时 HTTP Push 至指定服务器。 | 实时通知后台有人/无人,便于计费与联动。 |
| 安装方式 | 壁挂式,支持万向支架,需接交流电。 | 适合安装在茶室角落,居高临下探测。 |
3. API接口对接详解(技术实施步骤)
芯步的接口采用标准的 HTTP POST 请求,签名机制保证安全性,数据格式为 JSON,适用于任何支持 HTTP 请求的后端语言(Java, Python, PHP, Node.js 等)。
3.1 前置准备:获取凭证
在芯步开发者后台获取以下三要素:
AppID:应用标识。
AppSecret:接口密钥(严禁暴露在前端)。
Device ID:设备唯一ID(贴在设备背面或后台可查)。
3.2 核心难点:签名计算
为防止接口被恶意篡改,每次请求必须携带动态签名 sign。算法逻辑sign = MD5( MD5(AppSecret) + ts )流程说明
将你的
AppSecret做一次 MD5 加密,得到secret_md5;将
secret_md5与当前的 Unix 时间戳ts拼接;对拼接后的字符串再做一次 MD5,得到最终的
sign。
注:时间戳需精确到秒,且服务器时间偏差不宜过大。
3.3 关键功能开发:远程控制(通断电)
共享茶室最核心的需求是控制设备(如茶桌插座)的开关。通过 device/control 接口下发 power 指令即可实现。
请求示例(伪代码/命令行):
有人时:系统调用此接口,
{"power":1},茶桌通电。无人时:系统调用此接口,
{"power":0},茶桌断电并通知结算。
3.4 监听机制:接收设备上报(事件驱动)
传感器不会说谎,它会主动“告诉”你空间状态。你需要配置一个公网可访问的回调地址(Webhook)。
步骤:
在芯步控制台配置 “消息推送 URL”,例如
https://your-server.com/api/sensor/callback。当有人进入茶室时(红外触发 + 雷达确认),传感器会向该 URL 发送数据。
你的后端接收 JSON 数据。
上报数据格式示例(推测/模拟):
后端逻辑处理
状态机:必须维护一个状态变量。收到
occupancy时,如果订单未开始且未断电,执行通电;收到vacancy时,启动倒计时(如延时5分钟),倒计时结束后再次确认状态仍为无人,再执行断电。这能避免客人外出接电话时被误关。
4. 共享茶室业务场景流程
第一种场景:用户扫码开门到离店
用户下单:系统下发命令
power=1,茶桌供电,并忽略传感器数据(避免用户刚进门就上报无人)。使用中:传感器实时上报“有人”。
技术点:利用双模优势。如果用户静坐看手机(无红外移动,但有雷达微动),传感器依然报“有人”,系统保持通电。
中途暂离:用户出门接电话。传感器检测到红外+雷达均无信号 -> 上报“无人”。你的服务器逻辑:不立即断电,而是标记“暂离状态”,倒计时10分钟。
超时未归/退单:倒计时结束,传感器仍为无人。调用
power=0断电,并生成“设备已断电,请结束订单”的提示。
第二种场景:节能与联动
联动空调:仅在传感器上报“有人”且持续时间超过5分钟时,才允许空调开启;无人超过10分钟,强制关闭空调(节省电费)。
设备联动:该传感器带有一路AC输出。在布线时,可将照明灯直接接在该传感器的负载输出端。这样,即使网络断开,也能实现本地硬件联动:人来灯亮,人走灯灭,保证基础体验不依赖云端。
5. 常见问题与排障(FAQ)
Q:为什么明明茶室有人,系统却显示无人并断电了?A: 这就是传统的“单红外”传感器的弊端。芯步这款是双模,请检查后台配置是否同时开启了 radar_enable 和 infrared_enable 。如果只开了红外,静坐必然掉线。策略:业务逻辑上以雷达信号为主,红外为辅。
Q:接口返回签名错误(Sign Error)?A:
检查时间戳
ts是否为10位(秒级),而非毫秒级。检查 MD5 加密后的字符串是否为32位小写。
确认拼接顺序:
MD5(AppSecret)的字符串直接拼接ts数值,中间无连接符。
Q:传感器掉线(WiFi断开)怎么办?A: 该传感器支持设置 5组WiFi,录入周边多个信号强的AP(接入点)。同时,在SaaS系统中设计“设备心跳检测”功能,若设备离线,立即通知运维人员。
6. 总结
通过将芯步双模人体感应器的 HTTP API 深度集成到共享茶室的订单生命周期管理中,可以实现 “真感知、无感断电、极致节能” 的智能化改造。核心技术点在于利用 雷达+红外双重确认机制 解决了茶室场景最大痛点,并通过 异步回调机制 实现了服务端与硬件的实时联动。