针对芯步智能语音壁挂音箱（10W）的内置提示音播放需求，通过其开放接口，你可以直接调用预置的音效资源，无需录制音频文件。

以下方案详细说明了如何通过HTTP接口下发指令，实现铃声、提示音与警示音的播报。

1. 核心对接原理

芯步的智能音箱在出厂时已内置了音频库。你可以通过向设备发送特定指令来触发这些音效，而不是上传音频文件。

• 适用型号： 智能语音壁挂音箱（10W）。

• 指令类型： 支持铃声、提示音、警示音三类，每类各有5种变音。

• 通信方式： 支持HTTP POST/GET请求或MQTT协议。

2. 详细的对接步骤

2.1 准备工作：获取密钥与设备ID

在开始编码前，需要从芯步控制台收集以下信息：

1. AppID 和 AppSecret：登录控制台，在“开发设置”中获取。

2. 设备ID (Device ID)：在“设备列表”或音箱外壳标签上找到的唯一标识码。

2.2 签名计算 (Sign)

为防止接口被滥用，每次请求都需要携带动态签名。签名算法逻辑如下：

1. 将 AppSecret 进行MD5加密得到 secret_md5。

2. 拼接当前时间戳（秒级） tssecret_md5 + ts。

3. 对上一步的拼接字符串再次进行MD5加密，得到最终的 sign。*参考逻辑：sign = md5( md5(AppSecret) + ts )*。

2.3 接口地址

• 请求URL： http(s)://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

• Method： POST

• Content-Type： application/json

2.4 请求体参数说明

需要在JSON结构体中定义device和order两个字段

3. 具体指令构造指南

针对“内置提示音播放”，重点使用以下三个order参数

3.1 播放铃声

内置多种铃声，通常用于来电或门口机呼叫场景。

*注：ring 后的数字为1-5，代表5种不同的铃声风格。*

3.2 播放提示音

用于通用的成功、失败或消息到达提醒。

*注：message 后的数字为1-5，代表5种不同的提示音（如“叮咚”声等）。*

3.3 播放警示音

用于紧急、故障或安防报警场景。

*注：alert 后的数字为1-5，代表5种不同频率或节奏的警报声。*

4. 实战：使用cURL播放“提示音”

以下是一个完整的Shell脚本示例，展示了如何通过命令行触发音箱播放2号提示音。

5. 注意事项与最佳实践

1. 设备在线状态：API返回200仅代表指令已送达云端，设备若离线则无法播放。在控制台确认设备状态为“在线”。

2. 音量控制：在播放提示音前，可先下发指令调整设备音量，避免提示音过大或过小。

   • 命令示例："order": {"volume": 80} （假设音量为0-100）。

3. 停止播放：如果需要紧急打断当前播放的铃声或长文本，可以下发停止指令。

   • 命令示例："order": {"stop": ""}。

4. 网络要求：该设备仅支持2.4G WiFi，配网时请确保手机或路由器工作在2.4G频段。

通过以上步骤，即可快速完成对芯步智能语音壁挂音箱内置音效的对接，实现多场景下的语音提示功能。