芯步的AC1-10A智能通断器是一款开放HTTP接口的继电器控制模块，适合将传统电器快速接入软件系统。以下方案以“交流电路控制”为切入点，结合办公室场景中的排插、灯具、饮水机等设备，给出具体的接口调用、事件回调和安全设计思路。

解决方案：基于芯步AC1-10A的智能办公电路控制集成方案

1. 项目理解与核心逻辑

在智能办公场景中，“交流电路控制”本质上是通过软件控制物理电路的通断。芯步的 AC1-10A 智能通断器（产品型号：UNI-TDQ-AC1-10A）是实现这一目标的硬件。

• 核心功能：该设备内置继电器，支持 10A 电流（约 2200W 负载），通过接收 HTTP/HTTPS 指令，控制一路交流电路（L/N）的闭合（开）与断开（关）。

• 集成目标：将硬件接口封装成业务功能。例如：员工通过小程序点击“关闭投影仪” --> 软件调用硬件接口 --> 继电器断开 --> 投影仪断电。

2. 设计

为了实现高可用性和实时性，采用 “云云对接” 或 “应用直连” 的架构：

• 设备层：AC1-10A 通断器串联在办公室用电设备（如饮水机、工位插座、会议室投影幕）的前端。

• 平台层：芯步云平台。负责设备连接、状态上报、指令下发（HTTP接口）及事件回调（Webhook）。

• 应用层：你的业务服务器（企业 OA、小程序后端或 SaaS 系统）。负责业务逻辑处理、权限校验和设备指令调用。

3. 详细集成步骤

3.1 环境准备与设备配网

在芯步后台或批量配网小程序中，将 AC1-10A 设备注册并绑定到你的账号下。

• 关键动作：获取 Device ID 和 API Key/Access Token。

• 网络要求：设备需处于 2.4GHz Wi-Fi 覆盖范围内，以便与云端保持长连接。

3.2 软件接口对接流程

芯步提供标准的 HTTP 接口，无论你的后端（Java, Python, Node.js, Go）还是前端（JavaScript, 小程序），均可通过 四步法 集成：

第一步：鉴权与实例化

• 获取 AppKey 和 AppSecret。

• 生成签名，获取 Access Token。

第二步：设备控制（下发命令）这是最核心的部分，用以控制电路的通断。接口示例如下：

• URLhttps://api.unisoft.cn/ordercontrol

• Method：POST

• HeaderContent-Type: application/json, Authorization: Bearer [Access_Token]

• Body (JSON)

• 高级命令：除了简单的开关，AC1-10A 还支持自定义动作。

  • 点动模式：打开后自动关闭（用于门禁或电机）。

  • 延时模式：发送指令后，等待 N 毫秒再执行动作。

第三步：实时状态同步电路状态可能会被物理按键触发，也可能因过载保护跳闸。为了保持软件 UI 与物理状态的绝对一致，你需要配置 事件回调。

• 配置 Webhook：在你的软件后台设置一个公网 URL（如 https://yourdomain.com/api/device/callback）。芯步云端会在设备状态变化时，主动 POST 数据到这个地址。

• 处理逻辑：接收 JSON 数据，更新你本地数据库中的设备开关状态。

第四步：集成到业务场景将上述 API 调用封装成业务服务：

• turnOnDevice(deviceId) - 接通电路

• turnOffDevice(deviceId) - 断开电路

• getDeviceStatus(deviceId) - 查询当前状态

4. 典型办公场景应用

第一种场景：共享办公室/会议室节能控制

• 痛点：会议室使用完毕后，空调和照明常被忘记关闭，造成能源浪费。

• 解决方案

  1. 将 AC1-10A 串联在会议室的照明回路或总供电回路上。

  2. 集成企业 OA 预约系统：用户通过小程序预约会议室。

  3. 逻辑：会议开始前 10 分钟，软件自动调用 power：1 (开启) -> 通电 -> 员工进入即可使用；

  4. 会议结束扫码签退，软件自动调用 power：0 (关闭) -> 断电。

第二种场景：服务器机房/弱电井远程重启

• 痛点：路由器或 NAS 位于角落，死机后需人工拔插电源。

• 解决方案

  1. 将 AC1-10A 串联在路由器电源线上。

  2. 逻辑：网络监控软件检测到 Ping 不通 -> 调用接口下发关闭命令 value：0 (等待 5 秒) -> 调用接口下发开启命令 value：1 -> 设备强制重启。

  3. 注意：利用 AC1-10A 的“先断后通”或自定义延时功能，确保重启生效。

第三种场景：智能工位/插座能源管理

• 痛点：下班后员工工位仍存在“长明灯”或充电器待机耗电。

• 解决方案

  1. 在每 2-4 个工位的总线上安装 AC1-10A。

  2. 逻辑：基于公司考勤数据，例如在晚上 20：00 执行全公司“强制断电”指令。

  3. 为保洁或安保人员提供特定的“临时供电”权限接口，方便打扫。

5. 开发注意事项与最佳实践

1. 电路安全问题

• 绝缘与强电隔离：AC1-10A 直接控制 220V 强电。如果你的软件项目开发人员只懂代码不懂电，请一定要与电工配合。切勿在设备通电状态下触摸接线端子，接线时需遵循“L/N”标识（火零线输入输出）。

• 负载限制：虽然标注 10A，但在办公室集中控制场景，若控制多台电脑+饮水机（感性负载），降额至 8A 使用，避免继电器触点粘连。

2. 接口防重与调用机制

• 用户可能会在弱网环境下疯狂点击 APP 按钮。你的服务端必须做调用机制处理（例如：如果设备状态已经是 ON，再次收到 ON 指令时，不应下发云到端指令，而是直接返回成功）。

3. 网络容灾处理

• 断网情况：如果办公室 Wi-Fi 断了，虽然无法远程控制，但设备应保留最后一次的状态。你可以为设备配置“断电记忆”功能，即恢复供电后自动恢复断电前状态。

• 局域网控制：AC1-10A 除了公网 HTTP 接口，理论上支持局域网 Socket 控制。对于延迟敏感且与设备处于同一局域网的后台服务，使用局域网 IP 控制以降低延迟。

4. 异常告警

• 利用回调机制，当设备离线（Wi-Fi 断开）时，芯步会推送 offline 事件。你的系统应捕获该事件并及时通知管理员（例如通过钉钉/企微机器人）：“3楼茶水间接入点设备离线，请检查网络”。

6. 总结

通过集成芯步 AC1-10A 的 HTTP 开放接口，你可以在极短时间内（通常数小时）为你的软件项目赋予“控制物理世界”的能力。该方案无需关注底层复杂的网络通信协议（如 MQTT），只需调用简单的 RESTful API 即可实现：

开发者直接访问芯步官方文档中心，获取最新的 API Signature 签名算法 和 Postman 调试集合，快速启动你的智能办公项目。