酒店客房两路设备控制：怎样将智能2路交流远程控制开关接入到自己的项目中_解决方案

CATALOG

该方案的技术可行性已被验证——芯步的HTTP API在酒店场景下的实际应用，仕顿酒店的改造案例中已将平均响应延迟控制在0.3秒以内。对于“控制两路设备”这个具体需求，核心其实只涉及三个环节：设备配网、签名计算、命令下发。下面按集成顺序展开。

一、解决概述

本方案的目标是指导开发者如何利用芯步开放的HTTP API接口，将 “智能2路交流远程控制开关” （以下简称智能开关）快速集成到现有的酒店管理软件、微信小程序或手机APP中。

通过集成，开发者无需从零搭建物联网底层通信模块，只需通过标准的HTTP请求，即可实现对客房内两路电路（如：左侧床头灯、走廊灯或排气扇）的独立开关控制。

二、硬件准备与配网

在编写代码之前，首先需要完成设备的物理安装与网络配置。

硬件清单
- 智能触摸墙壁开关2路：标准86底盒安装，需接入零火线（注意：通常为单火或零火线版，请根据现场电路确认，常见为WiFi 2.4G直连）。
- 电源与网络：确保开关供电正常，且安装点位在酒店2.4G WiFi信号覆盖范围内（不支持5G WiFi）。
设备配网
- 下载并打开“芯步”或集成了SDK的控制端。
- 长按开关面板（或根据说明书操作）进入配网模式（指示灯闪烁）。
- 通过热点或蓝牙辅助，将设备连接到酒店客房的WiFi网络。
- 关键点：记录下平台生成的设备ID，这是后续控制该设备的唯一标识。

三、 API 接口集成详解

芯步对这款开关开放了标准的HTTP API，核心地址为：https://api.thingboot.com/{AppID}/device/control/。

1. 鉴权机制（签名计算）

为了提高安全性，接口采用动态签名鉴权。开发者需要在后端计算出Sign参数。

所需参数
- AppID：应用ID（在芯步控制台获取）。
- AppSecret：应用密钥（在芯步控制台获取，注意保密）。
- ts：当前Unix时间戳（秒）。
签名算法（以伪代码为例）：
# Step 1: 将AppSecret进行一次MD5加密 step1 = md5(AppSecret) # Step 2: 将step1的结果拼接上时间戳（字符串形式） step2 = step1 + str(ts) # Step 3: 对step2整体再做一次MD5加密 sign = md5(step2)

2. 核心指令：控制两路开关

这是本解决方案的重点。针对该2路开关，order字段支持控制第1路和第2路。

第一种场景：客人进门，插入取电卡，自动打开走廊灯（第一路）

请求URL： https://api.thingboot.com/你的AppID/device/control/?sign=xxx&ts=xxx
Method： POST
Header： Content-Type: application/json
Body (JSON) ：
{ "device": "这里填写设备的唯一ID", "order": { "power1": 1 } }
解析： "power1": 1 代表开启第一路继电器；"power1": 0 代表关闭。

第二种场景：客人睡觉前，关闭所有灯（第二路）

Body (JSON) ：
{ "device": "设备ID", "order": { "power2": 0 } }

第三种场景：特殊模式（先通后断） —— 适用于控制门铃或电机类设备如果2路开关控制的是门铃或卷帘电机，需要进行点动控制（先通电1秒再断电）：

3. Java 代码实现示例

为了更贴合实际开发，以下是基于Java（使用Unirest库）的对接示例：

import com.konghq.unirest.http.HttpResponse;
import com.konghq.unirest.http.Unirest;
import org.apache.commons.codec.digest.DigestUtils;

public class HotelLightController {
    public static void main(String[] args) {
        String AppID = "YOUR_APP_ID";
        String AppSecret = "YOUR_APP_SECRET";
        long ts = System.currentTimeMillis() / 1000;
        
        // 1. 计算签名
        String sign = DigestUtils.md5Hex(DigestUtils.md5Hex(AppSecret) + ts);
        String url = "https://api.thingboot.com/" + AppID + "/device/control/?sign=" + sign + "&ts=" + ts;
        
        // 2. 构建指令:打开第1路，关闭第2路
        String deviceId = "设备硬件ID";
        String orderJson = "{\"power1\":1, \"power2\":0}";
        String body = "{\"device\":\"" + deviceId + "\", \"order\":" + orderJson + "}";
        
        // 3. 发送请求
        try {
            HttpResponse<String> response = Unirest.post(url)
                .header("Content-Type", "application/json")
                .body(body)
                .asString();
            System.out.println("控制结果:" + response.getBody());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

参考来源自官方及开发者社区示例

四、酒店业务系统集成场景设计

仅仅控制开关是不够的，真正的价值在于与业务逻辑联动。以下是针对酒店场景的几个典型的集成方案：

与PMS系统对接
- 场景：客人在前台Check-in时，前台人员点击“办理入住”。
- 触发：后台自动调用API，向指定客房开关下发命令 {"power1":1} (打开廊灯或欢迎模式)，给客人一种“房间欢迎您”的体验，同时避免能源浪费（平时房间电总闸虽通，但灯路断开）。
“离家/离店”模式
- 场景：客人按动门外的“请即清理”按钮或退房时。
- 触发：系统调用API，下发 {"power1":0, "power2":0}，切断所有受控电器电源，帮助酒店节能。
本地局域网控制（高可用方案）
- 芯步的该款开关支持局域网通讯。对于网络稳定性要求比较高的五星级酒店，可以将API请求域名解析到设备内网IP，或在代码中配置故障转移逻辑。一旦外网断开，酒店内部局域网依然能下发控制指令。

五、注意事项与最佳实践

状态同步：官方接口文档指出，返回的code 200仅表示指令下达成功，不代表设备真的动作了。如果需要强反馈（如判断灯是否真的亮了），需要监听设备上报的属性更新推送（Webhook/MQTT），通过接收设备上报的当前状态来更新UI。
电源安全：交流远程控制开关必须由持证电工安装，严禁在带电的情况下接线。
网络配置：该款开关仅支持 2.4G WiFi。在酒店高密度的AP环境下，为IoT设备单独开辟一个SSID并关闭双频合一功能，以防连接不稳。
极简运维：参考仕顿酒店优化案例，好的智慧客房不仅要有接口，还要有运维看板。可以利用芯步提供的设备在线状态接口，在你的后台管理系统（PMS）中增加“设备离线报警”功能，工程部大屏上红色代表掉线，绿色代表运行。

六、总结

通过上述方案，可以将芯步的2路交流远程控制开关轻松集成至酒店自研系统中。整个过程归结为三步：

拿到ID：完成硬件配网，获取设备ID。
算出签名：后端利用AppSecret和时间戳计算出动态签名。
发个指令：向标准API接口POST JSON数据（如{"power1":1}）。

这种基于HTTP API的集成方式，打破了硬件与软件之间的壁垒，是构建低成本、高灵活性智慧酒店系统的有效途径。