共享茶室安全节能管理：如何把智能人体存在传感器[吸顶][红外版]接入到软件项目中_解决方案

CATALOG

芯步的红外人存在传感器通过HTTP接口上报“有人/无人”状态，并自带一路AC负载输出，可直接控制茶室照明或插座。以下方案聚焦如何将设备接入现有软件项目，实现有人自动通电、无人延时断电的闭环管理。

解决方案：共享茶室安全节能管理——智能人体存在传感器接入指南

1. 背景与选型依据

在共享茶室的运营中，常遇到“人去灯未灭”、“空调空转”导致的电费浪费，以及用户隐私顾虑（茶室不宜装摄像头）。选择芯步智能人体存在传感器 [吸顶] [红外版] 主要基于以下优势：

精准感知：不同于普通移动侦测，该传感器能判断人体静止存在（如静坐品茶），避免“人在灯灭”的尴尬。
强电控制：自带一路 AC 100-250V 输出，可直接切断/接通茶室内的照明或茶台插座，无需额外继电器。
开放接口：原生支持 HTTP 协议，数据上报和指令下发均采用标准 JSON 格式，可无缝对接现有的小程序后台、SaaS 系统或本地服务器。
易部署：采用 WiFi 直连（2.4GHz），吸顶安装，无需网关，降低实施成本。

2. 整体架构与数据流

本方案采用“端-云-管”的轻量级架构，无需芯步官方云台中转，数据直接推送到您的业务服务器：

数据上报：传感器通过 WiFi 探测区域内人体存在状态（有人/无人）。
服务器接收：状态变化时，传感器通过 HTTP POST 请求，将 JSON 数据直接推送到您配置的服务器 API 接口。
业务逻辑处理：服务器接收数据后，更新茶室状态，执行计费暂停或设备断电逻辑。
指令下发：服务器通过调用传感器的开放接口，远程控制传感器的 AC 输出线路（通断）。

flowchart TD
    A[红外传感器] -->|WiFi / HTTP上报| B[开发者服务器]
    B -->|业务逻辑判断
（是否超时/是否有人）| B
    B -->|HTTP下发指令
（控制继电器）| A
    A -->|物理断通电| C[茶室照明/插座]
    D[用户端小程序] <-->|查询状态/远程控制| B

3. 接入实施步骤

3.1 设备配网与服务器配置

在开始 API 开发前，需完成硬件初始化：

上电：按照说明书接入 AC 220V 市电，此时设备启动并发出热点信号。
配网：使用芯步官方配置工具（或内嵌于 App 的 SDK），将设备的 WiFi 指向茶室的 2.4G 网络。
设置回调 URL：在设备配置界面，将 “状态上报地址” 设置为您的业务服务器接口，例如：https://yourdomain.com/api/sensor/callback。
- 注：设备支持私有化部署，若处于纯局域网环境，可配置局域网内服务器地址。
关联 ID：记录下设备的唯一标识 device_id，并在您的后台将该 ID 与具体的茶室房间号绑定。

3.2 数据接收与解析（服务端重点）

当有人进入或离开茶室时，设备会自动向您设置的 URL 发送 POST 请求。请请一定要在服务端实现以下接收代码逻辑：

请求方式POST
Body 示例（根据红外版特性推测/参考）：

操作指引
1. 验签：为防止伪造请求，需校验请求头中的签名（Sign）和时间戳（Ts），签名算法通常为 MD5 或 SHA256（拼接 AppId + SecretKey），请严格参考 [芯步开放平台文档] 进行防重放攻击校验。
2. 业务处理
  - 收到 someone：判定房间占用。若此时订单状态为“空闲”，可自动触发“开始计费”或“通电”。
  - 收到 nobody：判定房间已无人。不立即断电，而是在服务器端启动一个“延时任务”（例如延时 15-30 分钟），期间若再次收到 someone 则取消延时，若超时则执行断电。

3.3 远程控制与联动（AC 输出管理）

该传感器最实用的功能是内置了一路 AC 输出。您可以将茶室的顶灯或茶桌总电源串联进此接口。通过 HTTP 接口下发指令，控制物理断电：

请求地址http(s)://api.thingboot.com/{AppId}/device/control/
请求参数

应用场景
- 安全节能：用户在小程序点击“结束订单”时，后台调用 {"power": 0}，强制切断茶台电源，防止用户离开后电器未关。
- 场景联动：若配合语音或按钮，可实现“一键启用”。

3.4 代码集成示例（伪代码逻辑）

以下逻辑需集成在你的后端服务中：

# 1. 接收设备上报的路由
@app.route('/api/sensor/callback', methods=['POST'])
def sensor_callback():
    data = request.get_json()
    device_id = data['device_id']
    presence = data['status'] # 'someone' or 'nobody'
    
    room = db.find_room_by_device(device_id)
    if not room: return 'error'
    
    if presence == 'someone':
        # 有人: 取消即将执行的断电定时任务
        cancel_power_off_task(room.id)
        # 确保设备通电（如果之前是断电状态）
        control_device(device_id, action='power_on')
        # 更新状态为"有人"
        db.update_room_status(room.id, status='occupied')
        pass
    else:
        # 无人: 启动延时断电任务 (如 30分钟)
        start_delay_task(room.id, delay_seconds=1800, func=power_off_room, args=(room.id,))
        
    return 'success'

# 2. 执行断电的函数
def power_off_room(room_id):
    room = db.get_room(room_id)
    if room.status == 'occupied':
        # 如果依然是有人状态，可能误判，不处理
        return
    # 调用芯步接口关闭电源
    http.post('http://api.thingboot.com/.../control/', json={
        'device': room.device_id, 
        'order': {'power': 0}
    })
    db.update_room_status(room.id, status='idle')

4. 共享茶室核心场景优化

4.1 防误判与“微动”检测

不同于廉价的红外移动传感器，该 [红外版] 虽然主要利用热释电技术，但结合其吸顶安装特性，能有效覆盖水平移动。针对茶室场景：

安装位置：安装在茶桌正上方吸顶（距地 2.5-3 米）。红外版对横向切割红外光束敏感，应避免直对空调出风口或窗外阳光直射处。
静止检测：如果红外版在用户静坐 15 分钟后误报“无人”，说明需要升级方案。目前该设备如配合雷达版效果更好，若仅使用红外版，软件逻辑上增加“点单/扫码”作为保活信号，或缩短无人判断延时（如 5 分钟用户不移动就断电，用户需重新扫码激活）。

4.2 访客体验流

进门自动亮灯：用户扫码开门瞬间（门磁触发），服务器可下发指令到传感器开启照明输出。
离座自动节能：用户离开去洗手间（无人状态触发），服务器延时 5 分钟断电；用户回来（有人信号恢复），服务器立即恢复供电，整个过程无感知。

4.3 安全告警

如果设备关断的是“茶炉”插座，请一定要在软件逻辑中加入 “强制断电” 按钮。当用户在订单结束后未带走物品，管理员可远程调用 API 切断该传感器的 AC 输出，杜绝安全隐患。

5. 总结

通过接入芯步 [吸顶][红外版] 传感器，共享茶室系统不仅获得了感知“人”的能力，更通过其集成的 AC 输出 获得了直接控制 220V 强电回路 的权限。整个接入过程基于标准的 HTTP 协议，开发工作量主要集中在 “接收到无人信号后的延时策略” 以及 “订单结束时主动断电” 这两块业务逻辑上，无需关心底层通信细节，即可快速实现“人来电通，人走电断”的无人值守管理目标。