芯步的智能语音壁挂音箱（15W）开放HTTP接口，可通过简单的API调用实现远程播放内置铃声和提示音。以下方案涵盖签名计算、命令格式、代码示例及常见场景配置。

解决方案：接入智能15W云语音壁挂音箱实现内置铃声提示音播放

1. 概述

芯步的智能语音壁挂音箱（15W）支持通过标准的HTTP API进行远程控制。开发者无需上传音频文件，只需调用特定接口并传入指令，即可播放设备内置的铃声、提示音或进行语音合成播报。

该方案适用于订单提醒、警报触发、设备联动播报等场景。

2. 前置准备

在开始接入前，请确保已在芯步平台完成以下准备工作：

1. 获取凭证

   • AppID： 应用唯一标识。

   • AppSecret： 接口调用的密钥（请勿泄露）。

2. 设备就绪

   • 确保“智能语音壁挂音箱（15W）”已通电并连接至互联网（WiFi 2.4G）。

   • 在平台控制台中获取设备的唯一标识符（Device ID）。

3. 网络环境

   • 由于是通过HTTP协议（公网API）下发指令，你的业务服务器需要具备访问外网的能力，或通过芯步私有化部署方案在局域网内调用。

3. 接口鉴权与签名机制

芯步的开放接口通过签名（Sign）来保证安全性。所有请求需遵循以下签名算法：

签名公式Sign = md5( md5(AppSecret) + ts )

详细步骤

1. 将 AppSecret 进行一次MD5加密，得到字符串 S1。

2. 拼接 S1 与当前的时间戳（秒级，例如 1700000000），得到字符串 S1ts。

3. 将 S1ts 再次进行MD5加密，得到最终的 Sign。

请求地址结构https://api.thingboot.com/{AppId}/device/control/?sign={Sign}&ts={Timestamp}

4. 核心功能实现：播放内置铃声与提示音

该设备内置了 5种铃声、5种提示音、5种警示音。你需要通过 order 参数中的特定字段来触发它们。

4.1 播放内置铃声

通过设置 "playRing" 字段，可以触发设备内置的预设铃声。该功能常用于来电提醒或到站提醒。

测试Demo：

在这个示例中，1 代表第一个内置铃声；你可根据实际配置需求选择1至5之间的数字来切换不同的铃声。

4.2 播放提示音与警示音

除了铃声外，设备内置的提示音（如“叮咚”）和警示音（如“警报”）也可通过类似方式调用，具体对应的字段名请参考下表：

调用示例：

5. 进阶功能：文本语音合成（TTS）

在许多场景下，固定的铃声无法满足需求。该音箱支持 文字转语音 功能，你可以直接推送文本让其朗读。

命令格式{"play:gbk:音量值":"文本内容"}

实践场景：当有人经过传感器时，播报“欢迎光临”。

注意：该设备支持调节语速、音色（男/女）、语调，具体扩展参数可参考具体设备的文档说明。

6. 集成代码示例

以下是一段使用 cURL 在 Shell 环境中运行的脚本示例。该脚本模拟了如何集成鉴权逻辑并下发“播放提示音”的指令。

7. 常见问题和需要注意的点

1. 设备不在线

   • 音箱断电或WiFi信号差会导致调用失败。在发送命令前，确保设备处于在线状态（可在控制台查看设备状态）。

2. 签名错误

   • 请严格检查时间戳（ts）的单位为 秒，而非毫秒（例如 1700000000 而不是 1700000000000）。

   • 确认MD5的加密结果为 32位小写 格式。

3. 音效叠加

   • 若正在播放TTS文本，此时又下发 playRing，设备通常会打断当前任务，立即执行最新指令。

4. 私有化部署

   • 如果你的系统部署在纯内网环境，请购买并部署芯步的私有化网关，此时API地址将变更为你的内网服务器地址，无需经过公网。

通过以上步骤，你可以快速将该音箱集成到现有的ERP、SaaS或本地自动化系统中，实现灵活的语音和提示音播报功能。