共享酒店公寓房态联动：如何把智能门禁照明控制器对接到项目中_解决方案

CATALOG

共享酒店公寓的痛点在于“人、房、电”的联动——客人下单后门禁怎么开？人离开后空调照明会不会浪费？芯步的开放接口恰好能低成本解决这些问题。以下方案围绕HTTP接口调用逻辑，说明如何将门禁、照明、传感器对接至现有PMS系统。

1. 背景与分析

在共享酒店公寓和短租民宿的运营中，房态同步滞后 与 能源浪费 是痛点。传统模式下，客人预订成功后，管家需手动为门禁更新密码；客人离店后，空调、照明往往通宵运作，导致运营成本飙升。

芯步的智能硬件产品线（门禁、照明控制、传感器）凭借其 “全开放HTTP接口” 和 “私有化部署” 能力，能够完美解决上述问题。本方案的目标是阐述如何利用这些产品的API接口，将硬件设备无缝对接到现有的PMS（酒店管理系统）或公寓SaaS平台中，实现“订单即授权，退房即断电”的全自动化闭环管理。

2. 设计

整个对接方案采用 “云-云” 或 “云-端” 直连架构。由于芯步的设备均支持WiFi直连且开放HTTP接口，我们无需购置第三方网关，即可实现业务系统与物理设备的双向通信。

应用层（PMS/小程序后台）：负责处理订单逻辑。当订单状态变更（如新建、支付、离店）时，系统自动触发API调用。
传输层（公网/局域网）：通过互联网调用芯步开放平台的API。如果项目对稳定性要求比较高，可采用其私有化方案，让服务器与设备在同一局域网内通信，彻底断网仍可工作。
感知/执行层（门禁、控制器）
- 门禁类：执行密码下发、电磁锁通断。
- 照明控制器：执行继电器通断，控制灯光与插座。
- 传感器：上报人体存在、门窗开关状态，触发联动逻辑。

3. 核心设备接口对接逻辑

芯步的接口设计极其简洁，通常仅需在URL中携带签名（Sign）和时间戳（Ts），并在Body中传递设备ID和指令即可。

通用API请求格式示例：

地址http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
Method：POST
Body{"device": 设备ID, "order": {"命令": 值}}

以下将分模块阐述具体对接实操：

3.1. 智能门禁与房态联动

目标：实现客人“自助入住，扫码开门”。涉及硬件：智能墙壁出门开关、密码门禁锁。对接流程

订单生成与密码下发：当客人在OTA平台下单并支付后，PMS系统通过接口向芯步设备发送指令。如果是纯门禁锁，可直接下发一次性或时段性密码；如果是控制电磁锁的出门开关（如UNI-系列），操作如下：
- 开锁命令{"device":820720, "order":{"power":0}} —— 即切断电磁锁电源，实现开门。
- 自动复位{"device":820720, "order":{"reset":5000}} —— 开锁5秒后自动恢复供电，门锁重新吸合，无需人工干预。
房态同步：通过门磁传感器（或门禁的反锁状态），实时将“已关门”状态上报至PMS，系统可将房态更新为“已入住/已清洁”。

3.2. 环境与照明控制器对接

目标：人走电断，人来预冷/预热，节能。涉及硬件：智能照明控制器、人体存在传感器。芯步特色产品：智能照明控制器（8路输出），一个设备即可控制全屋的客厅灯、卧室灯、插座、热水器等，非常适合公寓单间使用。

第一种场景：退房自动断电（PMS触发）当系统检测到客人点击“退房”或订单结束时间到达时，PMS后台自动调用API：

指令POST /device/control
Body{"device": 设备ID, "order": {"power": 0}} —— 切断该房间的总电路（保留冰箱等需持续供电的插座线路）。
衍生价值：结合功率计量功能（部分型号支持），系统可统计该房间本次入住的耗电量，为后续的“电费预付”或能耗分析提供数据支持。

第二种场景：节能模式与传感器联动（服务器端逻辑）由于芯步的传感器会上报状态到您的服务器，您可以利用这些数据自行编写控制逻辑：

数据上行：人体传感器检测到“无人”状态超过30分钟，向您的服务器发送通知。
逻辑处理：您的服务器接收到通知后，判断房间状态为“空闲且无人活动”。
指令下行：您的服务器调用照明控制器接口，发送{"order": {"channel_1": 0}}（关闭第一路灯光）和{"order": {"channel_8": 0}}（关闭空调插座电源），实现无人的情况下自动节能。

3.3. 场景控制与语音对接

目标：提升入住体验。实现的方式是由于芯步开放HTTP接口，任何第三方硬件或软件都能轻易控制它。

对接智能音箱：您可以直接将芯步的设备ID添加到小度、天猫精灵等第三方音箱的后台（如果支持自定义设备），或者通过您的云平台中转。客人在屋内喊一声“我回来了”，您的服务器即向照明控制器发送“情景模式”指令，如缓缓亮起廊灯、打开窗帘。
对接语音音柱：针对特定场景，可部署智能语音音柱Pro60W。当客人刷卡进门时，PMS可调用音柱接口，播报个性化的欢迎语（例如“欢迎尊贵的VIP会员李先生入住，房间温度已为您调节至24度”）。

4. 关键实施步骤

采用芯步方案的一大优势在于 “部署简单，开发快”。具体实施步骤如下：

第一阶段：设备选型与网络配置

硬件安装：在公寓配电箱内安装智能照明控制器（8路），替换原有86面板为智能门禁开关。
配网：设备通电后，使用APP为其配置WiFi。得益于其支持“5组WiFi”备份功能，即便主网络故障，设备也能自动切换至备用网络，极大提升了酒店公寓的稳定性。

第二阶段：API对接开发（约1-2天）

芯步的开放平台提供完整的API文档和代码示例，开发者只需关注业务逻辑：

获取AppId/Secret：在物联网控制台创建应用，获取密钥。
编写鉴权模块：按照文档规则生成Sign（签名），这是接口安全的基础。
核心逻辑编程
- 编写“退房回调函数”：调用照明控制器全关接口。
- 编写“入住回调函数”：调用门禁复位（通电）接口，并触发照明控制器打开欢迎模式。

第三阶段：联动测试

延迟测试：芯步设备的典型响应速度为80-120ms。测试PMS下发“退房断电”指令到设备继电器实际断开的时间，确保体验流畅。
断网测试：拔掉路由器WAN口，测试局域网内的设备控制是否依然正常（私有化部署模式优势）。

5. 方案价值总结

通过将芯步的开放接口对接进共享酒店公寓项目，我们实现了以下价值：

彻底自动化：PMS与门禁、电源的打通，彻底消灭了人工查房和手动发码的环节，客人凭密码/小程序即可自助办理入住和退房，退房后系统立即切断电源，杜绝空耗。
极低的改造成本：芯步的设备采用标准86盒安装或导轨安装，无需重新布线。一个“8路照明控制器”即可解决一室一厅的全部电源控制，相比传统的RCU客控系统，成本大幅降低。
数据驱动运营：通过硬件接口上报的用电数据和门禁状态数据，运营方可以清晰掌握每一间公寓的资产状态（如：某房间灯泡损坏可通过上报异常电流发现），实现精细化远程管理。

综上，凭借其 “免网关直连” 、 “百毫秒级响应” 以及 “全开放API” 的特性，芯步的智能硬件系列是共享酒店公寓实现智能化、无人化改造的高效选择。