CATALOG

芯步的40W云音柱支持HTTP接口直接调用,你只要会发POST请求,几分钟就能把它集成到自己的系统里。下面我按“硬件选型→接口对接→代码示例→场景应用”的顺序来写,尽量口语化,直接照着做就行。

一、先说这玩意儿是啥

你如果有停车场、工厂车间、仓库或者那种24小时自助洗衣房,肯定遇到过这种情况:车开出去了道闸没抬、机器故障没人知道、有人进敏感区域了也没个提醒。

这时候你就需要一个能“张嘴说话”的设备。芯步这款40W云音柱,说白了就是一个能联网的大喇叭,你通过代码给它发一段文字,它立马就给你读出来。防水防尘,户外随便用,音量够大,一个体育场都能听清

二、硬件长啥样?要买哪个版本?

2.1 外观和参数

这玩意儿长这样:150mm宽、100mm厚、335mm高,铝合金外壳,白色的,大概1.5公斤重。里面配了一个2寸高音和一个4寸中低音,声音穿透力没问题。

电源是DC 12V/3A,待机功耗不到2W,一点都不费电

2.2 选哪个型号?

芯步这系列分好几个版本,我帮你捋一下

型号后缀联网方式适用场景
UNI-YY-YZ-20W纯WiFi室内或WiFi覆盖好的户外
UNI-YY-YZ-20W-LANWiFi+网口要求网络稳定的地方,插网线最稳
UNI-YY-YZ-PRO-20WWiFi(支持音频+文本)不仅要播文字,还要播自定义音频
UNI-YY-YZ-PRO-LAN-20W网口+WiFi(音频+文本)全都要,最顶配

你要40W的话,直接问他们客服要同系列的40W版本,接口完全一样,就是功率更大。我个人买带网口的,毕竟无人值守场景,网络稳比啥都重要。

三、接入原理:其实就是一个HTTP请求

说破天也没啥高深的,就是你给它发一个HTTP POST请求,它收到就开吼

芯步开放的是标准的HTTP接口,你不管用啥编程语言——Java、Python、PHP、Node.js、甚至Shell脚本——只要能发HTTP请求就行。不需要上传录音文件,不需要搞什么WebSocket长连接,简单粗暴。

整个流程就三步:

  1. 设备插电连上网(首次配网用APP或者扫码)

  2. 拿到设备ID(在芯步控制台看)

  3. 写代码调接口,往那个URL POST一段JSON

四、动手接:接口怎么调?

4.1 准备工作

先去芯步官网注册个账号,登录控制台,拿到两个关键东西

  • AppId:你的应用ID

  • AppSecret:你的应用密钥(别告诉别人)

然后在设备列表里找到你那个云音柱的Device ID(设备ID),通常是一串数字。

4.2 接口地址和签名

接口地址格式是这样的

这里有两个动态参数:

  • ts:当前时间的Unix时间戳(秒),比如 1747212640

  • sign:签名,防止别人乱调你设备的。算法是:

    也就是先把AppSecret做一次MD5,然后拼上时间戳,整体再做一次MD5

4.3 最简示例:让它说“你好”

请求体是JSON格式,两个字段

  • device:设备ID

  • order:命令对象,播报文字就用 {"play:gbk:16":"你要播的内容"}

用Python写的话大概这样(我尽量写得很啰嗦,保证你能看懂):

就这么几行,运行完你的云音柱就该喊出来了。从你发请求到喇叭出声,大概80到120毫秒,基本感觉不到延迟。

4.4 其他常用命令

光会播文字肯定不够,你还可以控制音量、音色这些

功能order参数示例说明
设置音量{"volume": "7"}0-9级,0静音9最大
男声/女声{"voice": "1"}0女声,1男声
语速{"speed": "5"}0-9级
语调{"tone": "5"}0-9级
播文字{"play:gbk:16": "内容"}直接播
播提示音+文字{"play:gbk:16": "[message_3]欢迎光临"}message_1到message_5
播铃声{"ring": "3"}1-5五种铃声
停止播放{"stop": "1"}1全部停止

比如你想让声音小一点、用男声播“车辆识别成功”,就发:

五、实际场景怎么集成?

说完了技术,咱们聊聊怎么用到真实项目里。

场景1:无人停车场

车子开到入口,摄像头识别到车牌,你的后端系统判断这是月卡用户,直接调云音柱接口:

出口也一样,扫到车牌就喊“一路顺风”。如果遇到黑名单车辆,你甚至可以调成警报音:

场景2:自助洗衣房/充电桩

洗衣机洗完了,用户可能正在家里躺着呢,这时候除了APP推送,再让现场的云音柱吼一嗓子:“A区3号洗衣机已结束,请及时取走衣物”。下一个人来用的时候也能知道哪个机器空着。

场景3:工厂车间/仓库

AGV小车要经过路口了,让音柱提前播报“请注意,AGV正在通过,注意避让”。或者物料缺了,系统检测到库存低于阈值,自动播“B区货架物料不足,请及时补货”。比人工喊话高效多了。

场景4:景区/展馆

游客走进某个区域,通过红外或蓝牙感应,触发音柱播介绍。你可以分区域布置多个音柱,每个播各自的内容,接口里换不同的device_id就行。

六、几个小贴士

  1. 首次配网:云音柱一般支持WiFi和网线,WiFi配网通常用APP或者微信小程序扫设备上的二维码,按提示操作就行。固定IP,别让它自动获取,无人值守设备重启后IP变了很麻烦。

  2. 签名有效期:时间戳ts一般用当前时间,服务器会校验时间差,偏差太大会拒绝。所以每次请求都要实时生成新的ts和sign,不要写死

  3. 多设备同时喊:device字段可以传多个ID,用英文逗号隔开,比如"device": "820720,820721,820722",一条命令让所有音柱同时喊同样的话

  4. 数字读法:如果你播的是金额或者电话号码,可以控制读法。比如播“100元”你想让它读“一百元”而不是“壹零零元”,正常写就行,系统会自动识别。手机号也一样

  5. 多音字处理:遇到比如“重庆”这种,你可以在文本里标注拼音,具体格式看官方文档。

  6. 局域网使用:如果你不想走公网,芯步也支持私有化部署,接口地址换成你自己的服务器IP就行

总结

说白了,接入芯步的40W云音柱,核心就一句话:拼个签名,发个POST

整个过程不复杂,一个后端开发人员半天就能搞定。你也不用关心它底层的音频解码、网络重连那些破事,只管往接口里丢文字就完了。结合你项目里的业务逻辑(什么事件该触发提示),灵活地调用播报命令即可。

如果你想让音柱在播报前加个“叮咚”一声,就在文本前面加[message_1],用户反馈那个提示音很能吸引注意力。这玩意儿装上去之后,你的无人值守空间瞬间就变得“会说话”了,体验提升还是挺明显的。