共享办公包间常面临“设备控制分散、能源浪费严重”的痛点——用户预约后需手动开关各处设备，离开现场时时也容易遗忘关空调节灯。芯步的开放接口恰好能解决这个问题，通过统一API将灯光、空调等设备接入包间管理系统，实现“扫码即用、人走灯灭”的自动化体验。

1. 背景与需求

在共享办公业态中，独立包间（Focus Room / Private Booth）通常具备较高的使用周转率。用户在使用过程中常面临以下痛点：

• 操作繁琐：用户进入包间后，需手动寻找多个墙壁开关开启灯光和空调。

• 能源浪费：用户离开现场时后，因缺乏联动机制，常常出现“长明灯”和“空转空调”现象。

• 体验差：预约系统与现场设备分离，用户到达现场后设备不能自动就绪。

本方案的目标是利用芯步的开放接口与智能硬件，将包间的“灯光”与“空调”设备通过API进行统一管理，结合预约系统状态，实现用户端（App/小程序）的 “一键开门+一键开灯开空调” ，以及离开现场时后的自动关闭。

2. 整体系统架构

基于芯步开放的API能力，系统架构分为四层：

1. 感知/执行层（硬件设备）

• 智能控制器/4路：安装在包间配电箱内，通过继电器控制灯光的通断以及空调（风机盘管或壁挂机）的开关。

• 智能墙壁开关：替换原有开关，支持手动触摸与远程遥控，保留本地习惯。

• 环境传感器（可选） ：用于检测人体存在，辅助判断“真无人”状态。

2. 网络传输层

• MQTT/HTTP：设备通过Wi-Fi/4G网关连接芯步云。

• 芯步开放API：作为中枢接口，接收App指令并下发给设备。

3. 平台业务层（开发者负责）

• 共享办公SaaS后台：管理包间状态（空闲/使用中）、订单逻辑、用户权限。

• 芯步API集成模块：封装设备控制指令（灯光启停、空调模式切换）。

4. 用户交互层

• 用户端小程序：显示“开启包间”按钮。

• 管理后台：展示设备在线状态及能耗数据。

3. 硬件选型与连接

针对独立包间场景，推荐使用芯步的以下硬件产品组合：

3.1 灯光控制

• 推荐型号：智能控制器4路（交流电压版） 或 智能墙壁开关1路。

• 作用

  • 4路控制器：适合集成在天花板检修口，直接控制灯光回路；若包间内有筒灯、灯带、射灯多路线路，可分别接入1-4路进行独立控制。

  • 智能墙壁开关：保留传统86盒安装，用户按压手感不变，同时支持API下发指令控制通断。

• 关键指令{"power1":"1"}（开启第1路灯光）。

3.2 空调控制

• 推荐方案：智能控制器4路 + 红外发射模块（或直接通断控制）。

• 接线逻辑

  • 对于风机盘管空调：将控制器串联在空调的手拉手开关线路中，通过控制“高/中/低”风速继电器即可实现空调开关。

  • 对于普通壁挂机：需搭配红外遥控转发器，通过API下发红外码库指令。

4. 核心接口对接逻辑

芯步的接口设计直观，主要采用 HTTP POST/GET 方式。开发者需要重点对接以下两个环节：

4.1 设备控制（一键开启/关闭）

当用户在App/小程序中点击“开启包间”时，后台应调用芯步的 设备控制接口。

• 请求地址http(s)://api.thingboot.com/{AppID}/device/control/

• 核心参数说明

  • device：包间内预绑定的设备ID（唯一ID）。

  • order：具体的执行动作。

• 对接流程

  1. 用户下单完成，小程序按钮亮起。

  2. 点击“一键启用”，系统发送：POST /device/control/Body: {"device":"123456","order":{"power1":"1","power2":"1"}} (开启灯光1和2)同时下发空调控制指令：{"device":"789012","order":{"power":"1","mode":"cool","temp":"24"}}

  3. 设备继电器吸合，灯光/空调启动。

4.2 状态同步与防冲突

利用芯步的 消息推送 机制，实时接收设备状态变化，保障包间资源不冲突。

• 场景：用户手动按下墙上的开关关了灯，系统需要知道“设备已关”，从而判定包间空置。

• 实现：芯步云端会通过HTTP回调（Webhook）将设备的最新状态推送到开发者的服务器。开发者收到“灯关了”的信号后，自动将对应包间状态释放为“可预约”。

5. 场景联动逻辑实现

为了实现流畅的用户体验，开发者在SaaS层编写如下自动化逻辑：

第一种场景：用户预约并到达（一键开启）

1. 触发：用户扫描包间门禁二维码或点击App内“开门/开工”。

2. 鉴权：业务后台校验订单有效性。

3. 动作调用

   • 调用芯步API 控制 灯光 开启。

   • 调用API 控制 空调 启动（预设为24℃制冷/制热）。

4. 结果：环境一键就绪，用户无感进入工作。

第二种场景：预约结束/离开现场时无人（一键关闭）

• 方式A（用户主动） ：用户点击“结束使用”，后台调用API：{"power1":"0"}，切断所有继电器电源。

• 方式B（定时/传感器联动） ：

  • 设定逻辑：订单结束后延迟10分钟。

  • 调用传感器数据：通过API查询包间内的人体传感器状态。

  • 若判定“无人”，立即执行全关指令，杜绝能源浪费。

6. 详细指令参考表

基于芯步官方文档，以下是开发中具体的JSON指令示例：

7. 方案效益分析

• 对于运营方

  • 节能30%以上：通过API检测订单结束状态结合自动关机，防止下班后设备空转。

  • 简化布线：无需重新铺设复杂的KNX总线，利用原有强电线路 + 无线控制，改造一间包间只需10分钟。

• 对于用户

  • 体验升级：从“找开关”变为“手机一键控”，提升高端办公感受。

8. 开发注意事项

1. 签名机制 （Sign） ：芯步接口要求携带 sign 和 ts 参数进行身份验证。开发者需确保签名算法（MD5或指定哈希）的时效性，防止重放攻击。

2. 设备离线处理：调用接口返回 code 200 仅代表指令到达平台，不代表设备收到。业务层需配合查询设备状态接口或接收设备上下线推送消息，若设备离线应在前端提示“设备离线，请稍后重试”。

3. extra 字段应用：芯步支持在 order 中携带 extra 字段（如订单号）。当设备触发状态变更回调时，平台会原样返回该字段，极大方便了开发者进行订单与设备的绑定追溯。例如：{"power":1,"extra":"Order_12345"}。