CATALOG

芯步的语音音柱是通过HTTP接口控制的,你只需要向它的API地址POST一条JSON指令,就能让音柱开口说话。下面我从前台场景出发,整理了一套接入方案。

一、“哑巴前台”的痛点与升级思路

不知道你有没有经历过这种场景:客人走到前台,看你正在低头接电话或者处理订单,他站了十几秒你都没发现,气氛一度非常尴尬。或者是在退房高峰期,前台被围得水泄不通,后来的客人不知道去哪排队,甚至直接掉头走人。

其实,很多不必要的尴尬和流失,只需要一句话就能解决。

我们不需要花大价钱买那种能“对话”的高端AI机器人。针对“前台入住引导”这个场景,用一个 “会说话”的智能语音音柱就足够了。

芯步的这款30W智能语音音柱,说白了就是一个大号的外播喇叭,但它不是插U盘的,而是联网的。我们可以通过它背后的开放HTTP接口,让你的酒店管理软件(PMS/订房系统)在关键节点上,直接“命令”音柱说话

二、我们需要什么设备?

在动手之前,先把家伙什儿备齐了:

  1. 芯步 智能语音音柱 (30W) :这个功率放在前台或者大堂绝对够用了,声音洪亮但不刺耳。如果放在室外门口,防水等级也是够用的

  2. 12V直流电源:买设备通常会送,记得把插座留好。

  3. 2.4G WiFi网络:这玩意儿不支持插网线(部分型号支持,但30W款主要是WiFi),所以一定要确保前台WiFi信号满格

  4. 你的酒店管理后台/代码:也就是你要开发的这部分。

三、动手干:怎么把音柱“喊”答应?

厂家给的API文档看起来都是专业术语,可能会让一些人打退堂鼓。其实真上手了会发现,也就那么回事儿。本质上就是你的服务器给芯步的服务器发一条指令

这个过程主要是三步:

第1步:让音柱连上网(配网)

这一步就像是让音柱连上家里的WiFi。通常需要下载厂家的配网工具(或者用微信小程序),在App里输入WiFi密码,然后手机发出声波,音柱听到“哔哔哔”的声音就自己连上了。连上网后,后台会生成一个设备ID。这个ID非常重要,是音柱的身份证,你要把它复制下来记好

第2步:拿到开门的钥匙(获取AppKey/Secret)

在芯步的开发者后台,你需要创建一个应用。创建完之后,系统会给你两串字符:

  • AppID:相当于你的账号。

  • AppSecret:相当于你的密码,这个一定不要泄露在前端代码里

第3步:写代码发指令(核心)

我们需要通过后端代码发送一个HTTP POST请求。这是接口请求的万能公式:

请求地址 (URL):https://api.thingboot.com/{你的AppID}/device/control/?sign={签名}&ts={时间戳}

  • 重点说一下签名 (Sign):这是为了防止别人乱喊你的音柱。

  • 算法是:Sign = md5( md5(AppSecret) + ts ) 。也就是先把你的AppSecret进行一次MD5加密,然后把得出的结果加上当前的时间戳,再把它们拼接起来的字符串,再做一次MD5加密

  • 虽然听着绕,但在代码里其实就是两行md5函数的事。

请求体 (Body) —— 也就是你要让它说什么:

  • 命令解析“play:gbk:16” 你可以理解为“用GBK编码播放后面这段文字”。为什么用GBK?因为中文支持好,不会乱码

只要你这条请求发送成功(返回200 OK),音柱就会立刻:“你好,欢迎入住……”,基本没有延迟,实测通常在100毫秒左右

四、跟酒店项目怎么结合得更聪明?

光能手动调用接口还不够,我们要让音柱在合适的时机,说合适的话。这里有几个落地的玩法:

第一种场景:人体感应 + 音柱 —— “进门就是客”

在前台门口装一个人体传感器(也是芯步的,走同一个平台)。当传感器检测到有人走进前台区域时,系统自动触发接口。

  • 音柱播报“您好,欢迎光临。需要办理入住请前往前台,工作人员随时为您服务。”

  • 作用:哪怕前台员工正好在低头忙别的事,客人也不会觉得自己被冷落了。

第二种场景: PMS系统对接 —— 排队叫号

如果你们是那种公寓式酒店或者入住办理比较