芯步20W壁挂音箱支持通过HTTP接口直接调用内置铃声，无需预先上传音频文件。以下方案涵盖接口协议、签名算法、命令格式及多语言代码示例，帮助快速完成对接。

解决方案：基于芯步HTTP接口实现20W壁挂音箱内置铃声播放

1. 概述

芯步 20W 智能语音壁挂音箱 （UNI-YY-YX-BG-20W） 提供标准的HTTP API接口，支持远程控制。开发者无需复杂的配网或额外的音频文件处理，直接通过HTTP POST请求向设备下发特定指令，即可触发设备内置的铃声、提示音或警示音。

本文将以“播放内置铃声”为核心场景，详细介绍接口调用方法。

2. 前置准备

在开始对接前，请确保完成以下步骤：

1. 设备激活与配网：确保20W壁挂音箱已通电并连接至2.4G WiFi网络（设备支持5组WiFi备份，自动连接信号最强的网络）。

2. 获取凭证

   • 登录芯步控制台。

   • 获取 AppID 和 AppSecret （开发者密码）。

   • 获取目标音箱的 Device ID （设备ID）。

3. 接口协议与鉴权

所有控制命令均通过统一的API端点发送。

• 请求地址https://api.thingboot.com/{AppID}/device/control/

• 请求方法： POST

• 数据格式： JSON

• 鉴权方式： URL参数签名 （Sign）。

签名算法（MD5双重加密）：为了防止接口被恶意调用，请求需携带签名（sign）和时间戳（ts）。算法逻辑为：sign = md5（ md5（AppSecret） + ts ）。

• 第一步：将你的 AppSecret 进行MD5加密，得到字符串 S1。

• 第二步：将 S1 与当前Unix时间戳（秒级，如 1715328000）拼接成 S1ts。

• 第三步：将拼接后的字符串再次进行MD5加密，得到最终的 sign。

4. 核心指令：播放内置铃声

20W壁挂音箱内置了多种铃声、提示音和警示音，无需上传MP3文件。通过 order 参数中的特定Key即可触发。

支持的命令类型

命令格式构造：请求体中的 order 字段是一个JSON对象。若要播放铃声，需构造如下：

注意：不同的产品系列命令略有不同，请以设备对应的“产品手册”为准，20W壁挂音箱通常支持上述标准命令。

5. 请求示例

假设你的参数如下：

• AppID： YOUR_APP_ID

• AppSecret： YOUR_APP_SECRET

• Device ID： 123456789

• 当前时间戳 （ts）： 1715328000

• 目标： 让音箱播放 2号铃声，并将音量调至 7。

Step 1： 计算签名

1. S1 = md5（“YOUR_APP_SECRET”） （假设结果为 abc123...）

2. S2 = S1 + “1715328000”

3. sign = md5（S2）

Step 2： 发送HTTP请求

请求URL：POST https://api.thingboot.com/YOUR_APP_ID/device/control/？sign=计算出的签名&ts=1715328000

请求Body （JSON）：

（注意：可在 order 中同时传入多个指令，设备将按序执行）

Step 3： 多语言代码片段

Python 示例

Java 示例

Shell （cURL） 示例

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

1. 响应延迟：该系列产品采用硬件级TTS合成与指令解析，从云端下发指令到音箱发出声音通常在 80ms-300ms 之间，属于正常范围。

2. 网络环境：由于设备使用WiFi连接，请确保设备安装位置信号强度足够。若处于纯内网环境（无互联网），芯步支持私有化部署方案，可将API接口部署在本地服务器。

3. 命令优先级：如果同时下发 play （文本播报） 和 ring （铃声），设备通常会按接收顺序处理，或根据固件版本不同存在播报抢占逻辑。若需实现“铃声响起 -> 播报内容”的流程，在业务代码中按顺序调用接口（先下发铃声，等待特定时长再下发播报文本），或利用 stop 命令先停止当前任务。

4. 铃声选择：目前 ring， message， alert 三个参数各支持至少5种不同的内置音频。可以通过修改数字 1-5 进行切换，具体的音效特征（如“叮咚”、“警报长鸣”）在实际部署前通过调试接口试听确认。

通过以上步骤，你可以快速将芯步20W壁挂音箱集成到你的业务系统中，利用内置铃声实现高效的语音通知。