一、概述
在KTV、棋牌室、剧本杀店这类服务型门店里,顾客喊一嗓子就能开关空调、调灯光、启动麻将机——这不是科幻片,是现在就能实现的事。
芯步的8路包间电器覆盖控制器(UNI-KZQ-BJ-MAX) 配合智能语音设备,通过开放的HTTP接口,能让你的包间秒变“听话”的智能空间。这套方案的核心逻辑很简单:语音指令 → 后台解析 → HTTP命令 → 控制器执行。
下面我手把手拆解怎么对接,包括硬件怎么接、接口怎么调、代码怎么写。
二、硬件准备:认识这台8路控制器
先看看手里这台设备能干啥。芯步这款控制器把包间里所有电器都考虑进去了,8路输出各有分工
| 路数 | 接口类型 | 适用电器 | 负载能力 |
|---|---|---|---|
| 第1-3路 | 10A开关 | 照明灯、换气扇、吸烟灯 | 2200W(阻性)/350W(感性) |
| 第4-6路 | 16A插座 | 饮水机、麻将机、按摩椅 | 3500W(阻性)/500W(感性) |
| 第7路 | 10A门禁接口 | 电磁锁、电插锁 | 2200W(阻性)/350W(感性) |
| 第8路 | 30A插座 | 2匹空调 | 6600W(阻性)/1100W(感性) |
选哪个版本? 直接选TTS语音播报版——这样除了控制电器,还能让设备播报“空调已打开”、“您的时长还剩30分钟”这类提示,体验直接上一个档次。
联网方式:设备走2.4G WiFi,配网后通过云端API控制,不需要公网IP,部署成本低。
三、对接核心:HTTP接口调用详解
芯步的开放接口用的是标准HTTP POST,签名防篡改,结构很简单。
3.1 接口地址
3.2 签名算法(重要!)
拆解一下:
先把你的
AppSecret做一次MD5加密把上一步的结果拼上当前时间戳
ts对整个拼接字符串再做一次MD5
注意
ts必须是Unix时间戳(秒级),而且前后误差不能太大,一般5分钟内有效。
3.3 请求参数
device:设备唯一ID,在芯步控制台能看到order:命令JSON,具体命令见下表
3.4 支持的控制命令
| 功能 | 命令示例 | 说明 |
|---|---|---|
| 控制单路 | {"power1":1} | 1代表开,0代表关 |
| 控制多路 | {"power3":0, "power5":1} | 同时控制多路 |
| 批量控制 | {"batch":[1,3,5]} | 批量开启指定线路 |
| 先通后断 | {"point":[1,2]} | 切换模式 |
| 语音播报(TTS版) | {"play:gbk:16":"空调已打开"} | 设备直接念出来 |
关于语音播报格式:
play:gbk:16中的16代表音量级别,范围0-16,数值越大音量越大。
四、实战:对接智能语音助手
现在进入正题——怎么让顾客的语音命令真正控制到电器。
4.1 整体架构
语音这块有两种方案:
方案A:用现成的智能音箱(小爱/天猫精灵等)
优点:成熟稳定、成本低
缺点:对接需要走音箱厂商的技能平台,稍微折腾点
方案B:用芯步的智能语音设备(语音音柱/吸顶喇叭)
优点:直接调HTTP接口就行,不用过第三方
缺点:需要自己处理语音识别(当然也可以走云服务商ASR)
以方案