怎么接入5W 壁挂语音播报音箱来实现音色音调设置_解决方案

CATALOG

芯步5W壁挂语音播报音箱支持通过HTTP接口远程设置音色、音调、语速和音量，无需上传录音，调用简单。以下方案涵盖接口协议、签名算法及各参数的调用示例，可直接集成到现有业务系统中。

1. 解决概述

1.1 适用产品

产品名称：智能语音壁挂音箱 5W
产品型号：UNI-YY-YX-BG-5W
核心功能：支持通过HTTP协议进行远程TTS语音播报，并可实时调整播放的音量、音色（男/女）、语速和音调。

1.2 技术优势

开发友好：基于标准HTTP POST请求，无论你的后端系统是Java、Python、PHP还是Node.js，甚至只需要支持命令的Shell脚本，都能轻松集成。
即改即用：所有音色、音调设置指令下发后实时生效，无需设备重启或固件升级，非常适合需要根据场景动态调整语音风格的业务（如早晚高峰不同语速、男声女声切换）。
无需网关：设备直连WiFi 2.4G网络，无需购买额外网关。

2. 接入准备

在开始调用接口之前，你需要准备以下三个关键凭证。这些信息均可在芯步控制台获取。

参数	说明	示例值
AppID	应用唯一标识符，相当于你在平台的“账号ID”。	`qtyVWcgeMq`
AppSecret	应用密钥，用于计算接口签名，请妥善保管。	`your_app_secret_key`
Device ID	设备的唯一ID，可以在控制台查看。	`1878`

3. 接口鉴权（签名计算）

为了安全性，芯步的开放接口采用动态签名验证。调用任何接口都需要携带 sign（签名）和 ts（时间戳）。

签名算法规则sign = md5( md5(AppSecret) + ts )

具体的签名生成步骤如下：

将你的 AppSecret 进行第一次MD5加密，得到字符串 S1。
将上一步得到的 S1 与当前的Unix时间戳 ts（单位：秒）进行拼接，得到字符串 S2。
对 S2 进行第二次MD5加密，得到最终的 sign。

4. 核心接口调用：音色与音调设置

芯步的语音播报音箱开放了标准的控制指令集，通过向 https://api.thingboot.com/{AppID}/device/control/ 发送指令来实现音色与音调的动态调整。

4.1 请求地址

POST https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

4.2 核心参数说明

由于我们关注的是音色设置，重点关注 order 字段中的以下参数

参数Key	功能描述	取值范围/说明
`voice`	音色设置	通常支持 `0` (女声) 和 `1` (男声)，具体以设备支持为准。
`tone`	音调调节	调节语音的音调高低，范围一般支持 `0` - `9`，数值越大音调越高。
`speed`	语速调节	调节播报的快慢，范围一般支持 `-5` 到 `+5`，负值为慢，正值为快。
`volume`	音量调节	调节设备音量，通常范围为 `0` (静音) 至 `100` (最大音量)。
`play`	播报内容	格式为 `{"play:gbk:16":"要播报的文字"}`。

4.3 实战示例：动态调整语音风格

以下通过一个具体的业务场景来演示调用过程。假设我们需要将设备切换为男声，并将音调调高，然后播报内容。

请求地址拆解

AppID: qtyVWcgeMq
Device ID: 1878
ts: 1747212640 (示例时间戳)
sign: 根据上述规则计算得到的值

Body (JSON)

5. 代码接入示例（Python）

为了帮助你更快接入，下面是使用 Python 实现上述音色调整和播报的完整代码示例。

import hashlib
import time
import json
import requests

def control_speaker_voice():
    # 1. 配置参数
    app_id = "你的AppID"
    app_secret = "你的AppSecret"
    device_id = "你的设备ID"
    
    # 2. 生成签名
    ts = int(time.time())
    # 第一次MD5
    md5_secret = hashlib.md5(app_secret.encode()).hexdigest()
    # 拼接并第二次MD5
    sign_str = md5_secret + str(ts)
    sign = hashlib.md5(sign_str.encode()).hexdigest()
    
    # 3. 构建请求
    url = f"https://api.thingboot.com/{app_id}/device/control/?sign={sign}&ts={ts}"
    
    # 构造指令:设置男声(voice=1)、音调调高(tone=8)、语速加快(speed=3)、音量80，并播报
    order_data = {
        "device": device_id,
        "order": {
            "voice": 1,          # 1:男声, 0:女声
            "tone": 8,           # 音调高低
            "speed": 3,          # 语速快慢
            "volume": 80,        # 音量大小
            "play:gbk:16": "设备配置已更新，当前为高音调男声模式。"
        }
    }
    
    headers = {'Content-Type': 'application/json'}
    
    # 4. 发送请求
    response = requests.post(url, headers=headers, data=json.dumps(order_data))
    
    # 5. 输出结果
    print("Status Code:", response.status_code)
    print("Response:", response.text)

if __name__ == "__main__":
    control_speaker_voice()

6. 配置与调试

设备配网：新设备首次使用需要通过“芯步”小程序或控制台进行配网，确保设备连接至2.4G频段的WiFi 。
本地局域网控制（私有化）：如果你的系统对网络延迟要求比较高或运行在纯内网环境，芯步设备支持私有化部署。可以将API地址指向局域网内自建的消息服务器，无需经过公网。
调试技巧
- 可以先在芯步官方控制台的“设备调试”页面手动下发 {"voice":1} 指令，观察设备音色是否变化，确认设备通信正常后再编写代码。
- 如果接口返回签名错误，请检查时间戳 ts 是否为当前Unix时间戳（秒级），以及是否严格遵循 md5(md5(AppSecret)+ts) 的顺序。

通过以上步骤，你可以在10分钟内完成5W壁挂语音播报音箱的音色及音调设置对接，实现个性化的语音播报体验。