怎样对接60W 远程控制户外防水音柱来实现远程 TTS 语音播报_解决方案

CATALOG

针对芯步 60W 远程控制户外防水音柱（型号：UNI-YY-YZ-PRO-60W），通过其全开放的 HTTP API，你可以非常方便地集成 TTS（Text To Speech，文本转语音）功能。该方案不受编程语言限制，无论是网页、小程序还是后端服务都能轻松对接。

以下是详细的对接解决方案：

芯步的音柱设备内置了 TTS 芯片，在设备端直接完成文本转语音，而不是在云端或手机端合成后再推送音频。这意味着你只需要通过 HTTP 请求将文本内容发送给设备，设备即可毫秒级响应并播报。

在开始编程之前，你需要获取以下三样关键信息：

获取 AppID 与 AppSecret
- 登录芯步开发者控制台。
- 在“开发设置”中查看你的应用ID（AppId）和开发者密码（AppSecret）。
获取设备 ID
- 在控制台的设备列表中找到你将要控制的 60W 音柱，获取唯一的 Device ID（例如：820720）。
设备联网
- 确保 60W 音柱已通电，并连接至互联网（支持 2.4G WiFi 或有线网络）。

芯步的接口设计非常简洁，核心是构建正确的签名和请求体。

为了防止接口被恶意调用，每次请求都需要携带签名。算法规则如下

Sign = md5( md5(AppSecret) + ts )

示例计算流程假设 AppSecret = "abc123"，ts = 1700000000。

URL 结构http(s)://api.thingboot.com/{AppId}/device/control/?sign={Sign}&ts={ts}
Method：POST
Content-Type：application/json

要让 60W 音柱说话，核心在于 order 参数的构建。以下是几种常见的播报场景：

直接让音柱说出你想说的话。

命令解释：play:gbk:16 表示以 GBK 编码播放后面附带的文本内容。

在实际场景中，往往需要先播放提示音引起注意，或者调整音量。

命令解释：[message_3] 是内置的提示音，播报时会先“叮咚”一声，随后播报文字。

如果需要紧急打断当前的播报，可以发送停止指令。

由于接口基于 HTTP，以下展示两种最常用的对接方式。

60W 音柱的特性
- 户外防水：该型号音柱外壳为铝合金材质，具备防尘防水能力，适合户外露天环境。
- 大音量：60W 功率适合停车场、园区、工厂车间等空旷嘈杂环境。
多音字与数字处理
- TTS 引擎支持智能读法。金额通常会自动读作“一百二十三元”，手机号会按数字位读。如果遇到多音字错误，目前主要依赖上下文智能识别，或尝试用同音字替代。
网络稳定性
- 该设备仅支持 2.4G WiFi 或有线网络，不支持 5G WiFi。在户外部署时，请确保信号覆盖。
私有化部署
- 如果你的系统部署在纯内网环境，该设备支持私有化部署，可将 API 地址指向本地服务器。
灵活的命令组合
- 除了 play:gbk:16，你还可以在 order 中组合 speed（语速 0-9）、tone（语调 0-9）等参数，以达到最佳听觉效果。