酒店前台入住引导语音提示场景：怎样将20W 智慧园区语音终端对接到自己的项目中_解决方案

CATALOG

芯步这套20W语音终端的开放接口比较简单——就是发HTTP请求，不需要折腾复杂的SDK。下面我从硬件选型、对接流程到代码示例一步步说清楚。

在芯步的产品线里，你提到的 20W 设备通常指 “智能语音音柱”或 “智能语音吸顶音箱” 。

针对酒店前台场景，我个人选择 “智能语音音柱” ，原因如下：

通常情况下，你们的项目（无论是微信小程序、PC端前台软件还是自助入住机）跑在云端或者酒店的服务器上。

对接逻辑其实很简单：

这里有一个特别实用的点：芯步的接口不仅支持文字转语音（TTS），还支持直接播 MP3。如果你希望开场白有一段好听的“叮咚”提示音，可以先上传音频文件，然后调用播放。

假设你的开发语言是 Python 或 Java，对接过程大致如下：

在芯步开放平台创建一个应用。你会拿到 AppID 和 AppSecret。这两个东西是你在云上的“账号密码”，千万别泄露。

设备到手后，用手机 App 或者设备自带的配网功能，给它连上酒店 WiFi。只要它在后台显示“在线”，就可以开始下一步了。

我们以 “客人刷身份证成功，准备办理入住” 这个场景为例，我们需要音柱播报：“欢迎光临 XX 酒店，请出示您的身份证件。” 或者针对续住客人播报：“欢迎回来，正在为您办理续住。”

接口地址你需要向这个地址发请求（注意替换 {AppID}，以及计算签名）：http(s)://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

这里有个小窍门：由于官方的签名验证（sign）可能会增加一些开发量，如果你比较急，可以先把 “调试模式” 打开，或者在后台上送我们一个临时的签名计算脚本。但生产环境下，签名规则是：md5(md5(你的密钥) + 时间戳)。

请求参数示例（JSON格式）：我们直接使用 order 字段来包含要说的内容。假设我们要求设备播放文本“您好，欢迎光临”。

如果你们希望更高级一点，比如播放带背景音乐的文件，只需要把 tts 换成 play 并指定音频链接即可

既然你是做“前台入住引导”，我强烈你不仅仅在“办理中”提醒，可以加入以下逻辑，这会让酒店方觉得你们很专业：

防呆设计（人未到，声先到） ：当自助机或人脸识别摄像头检测到有人靠近（距离传感器触发），音柱自动播报：“欢迎光临，请在这里刷身份证。” —— 这能有效减少客人的茫然感。
忙碌提醒（避免投诉） ：当前台只剩一个人在办理，后面排起长队时，前台电脑上点一下“排队提醒”，音柱播报：“请稍等，我们将依次为您办理。” —— 这在节假日非常有用。
夜班静音模式晚上 11 点后，通过 API 下发音量调节指令 {"volume": 30}，避免打扰大堂休息的客人。

作为给开发者的，有几个地方提前注意，能让你省半天时间：

关于“下发成功”与“播放成功”接口返回 code: 200 代表“指令发出去了”，不代表音柱“响了”。如果音柱没响，检查两点：
- 音柱是不是离线了（WiFi 断了）？
- 是不是没开音量？解决方案： 如果你的项目要求高，可以配置芯步的消息推送，监听设备上报的状态，确认它真的播完了。
局域网还是公网？芯步的设备默认走公网（云端），只要你的服务器能上网就能控制。但如果你怕酒店断网，芯步设备也支持私有化部署（MQTT局域网控制），直接把指令发到酒店局域网内的自建服务器上，断网也能用。
并发场景如果酒店很大，前台放了 2 台音柱（一个接待位一个会员窗口），你可以在代码里建两个 device 配置。注意：一次请求可以控制多个设备，用逗号隔开设备 ID 就行，比如 device=111,222。