文档中心

从开箱到接入：设备、面板、账号与接口文档。

快速上手

开箱检查 → 通电 → 配网（仅 G01 网关）→ 绑定 → 遥控。

设备与配网

G01 网关 Wi-Fi 配网、蓝牙直连、灯组件与红外遥控说明。

接口与开放能力

REST / WebSocket 契约、鉴权方式、错误码与调用示例。

快速上手

  1. 开箱检查：确认三态刀主机、电源、随机红外遥控器与说明书齐全。
  2. 通电启动：按说明书接入电源，等待指示灯进入待连接状态。
  3. 配网（仅 G01 网关）：手机靠近网关，进入 Wi-Fi 配网，选择 2.4G 网络并输入密码；灯组件不支持 Wi-Fi 配网。
  4. 绑定设备：登录后进入遥控面板，用产品码/手动输入获取设备；也可在小程序「绑定设备」操作。
  5. 开始遥控：网页、Android App、微信小程序共用同一面板；近场可用蓝牙，联网后可用云端远程。

打开遥控面板

设备与配网

Wi-Fi 配网（G01 网关）

仅 G01 网关支持。使用 2.4G Wi-Fi、手机靠近设备、密码正确；5G 网络不支持。配网失败可先改用蓝牙直连。

蓝牙直连

手机靠近设备并开启蓝牙权限；灯组件使用 0xFFE0 Profile，网关使用 0x0101 Profile。小程序与 App 均支持。

红外遥控器

随机附红外遥控器，可直接控制电源、色彩、亮度与风道，不依赖网络。

设备绑定

登录后输入设备编号；部分设备需管理员审核。绑定码一次性有效，请勿转发。

接口与开放能力

账号中心与设备控制使用同一套 REST / WebSocket 契约；正式接入前请先在控制台创建 API Key（开放平台按批次开放）。

能力路径 / 方式说明
登录POST /api/v1/auth/login账号密码换 JWT；请求体 {account,password}
设备列表GET /api/v1/devicesBearer 鉴权；返回本人可见设备
设备状态GET /api/v1/devices/{sn}/state返回 online 与 D3 状态
下发指令POST /api/v1/devices/{sn}/command扁平 D3 JSON；viewer 只读 403
实时状态WS /ws?sn=&token=状态推送；断线指数退避重连

完整契约与错误码以部署环境的接口文档为准；未开通的能力会明确返回 501/403，不伪造成功。

常见问题

搜不到设备 / 一直离线

确认设备已通电、指示灯正常；蓝牙连接时手机靠近设备并开启权限；云端控制需设备已联网。

配网总是失败

确认 2.4G Wi-Fi、密码正确、手机靠近网关；仍失败可先改用蓝牙直连。

售后与保修

保修条款以随附说明书为准；可拨打 13692743044（韩生）或通过 服务工单 联系。