怎么接入智能 20W 语音音柱来实现远程 TTS 语音播报_解决方案

CATALOG

智能硬件的开放接口用起来其实不复杂，关键在于走通“设备ID获取 → 签名计算 → TTS指令下发”这条链路。下面我把20W音柱（实际指令格式和10W款一致）的接入流程一步步说清楚。

一、准备工作：找到你的“钥匙”和“门牌号”

在开始写代码之前，我们得先去芯步的后台拿两样东西，这就好比你要发快递，得知道商家ID和收件人地址。

获取 AppID 和 AppSecret (开发者密码)
- 登录芯步的“物联网控制台”。
- 在“开发设置”里，你能看到一串像 qtyVWcgeMq 这样的 AppID，还有对应的 AppSecret。
- 注意AppSecret 非常敏感，别把它写在网页前端的代码里，最好放在后端服务中。
获取 Device ID (设备ID)
- 既然你用的是 20W 语音音柱，先去“设备列表”里找到它。
- 设备ID通常是一串数字，比如 1878 或者 12345678。记下这个号码，这就是你要喊话的“大喇叭”的身份证。

二、核心原理：其实就发一条指令

芯步的接口设计得很直白，就是把控制指令包装成 HTTP 请求发出去。针对 20W 智能语音音柱，核心指令就是 {"play:gbk:16":"你要说的话"}。

接口请求地址（注意替换大括号里的内容）：https://api.thingboot.com/{你的AppID}/device/control/?sign={你的签名}&ts={当前时间戳}

这里面比较绕的一点是 签名 (sign)。别怕，它只是一个防止别人乱发指令的验证机制，公式很简单：sign = md5( md5(AppSecret) + ts )。

三、实战代码：用 Python 让她开口说话

为了详细说明，我们直接用 Python 代码来演示。假设场景是：每当有新订单时，音柱自动播报“您好，您有新的外卖订单，请及时处理”。

import requests
import hashlib
import time
import json

# 1. 配置参数（替换成你后台的数据）
APP_ID = "qtyVWcgeMq"       # 你的AppID
APP_SECRET = "你的开发者密码"  # 你的AppSecret
DEVICE_ID = "1878"           # 你的20W音柱设备ID

# 2. 生成签名 (这是最容易错的一步，照着来就行)
def generate_sign(secret, ts):
    # 官方规则:md5(md5(开发者密码) + ts)
    step1 = hashlib.md5(secret.encode()).hexdigest()  # 第一次MD5
    step2 = step1 + str(ts)                            # 拼接时间戳
    sign = hashlib.md5(step2.encode()).hexdigest()     # 第二次MD5
    return sign

# 3. 构建请求
ts = int(time.time())                     # 获取当前Unix时间戳（秒）
sign = generate_sign(APP_SECRET, ts)      # 计算签名

# 拼接完整的URL
url = f"https://api.thingboot.com/{APP_ID}/device/control/"
params = {
    "sign": sign,
    "ts": ts
}

# 4. 构造"让音柱说话"的命令
# order 字段是一个 JSON 字符串
# play:gbk:16 代表播放文本，16代表音量（0-9范围，16是示例值，实际0-9）
# 如果你想加个提示音，比如 ding~ 一下，可以用 [message_1] 开头
text_to_speak = "您好，您有新的外卖订单，请及时处理"
order_payload = {
    "play:gbk:16": text_to_speak     # 核心:TTS播报指令
}

# 还可以顺便控制一下音量和音色（可选）
# order_payload["volume"] = 8        # 音量调到8
# order_payload["voice"] = 1         # 音色:0女声，1男声

body = {
    "device": DEVICE_ID,
    "order": json.dumps(order_payload)   # 注意:order 必须是 JSON 字符串格式
}

# 5. 发送指令
print(f"正在向设备 {DEVICE_ID} 发送语音指令...")
try:
    response = requests.post(url, params=params, data=body, timeout=5)
    result = response.json()
    
    if result.get("code") == 200:
        print("指令已送达，音柱即将播报！")
    else:
        print(f"下发失败，错误码:{result.get('code')}，原因:{result.get('msg')}")
        
except Exception as e:
    print(f"网络请求出错:{e}")

# 额外小贴士:
# 如果音柱没响，请检查:
# 1. 签名算法（ts和sign有没有对齐）
# 2. 设备ID是否正确（别拿成了网关ID）
# 3. 音柱是否在线（在控制台看设备状态是不是"在线"）

四、更优雅的用法：不仅仅是干巴巴的文字

通过 order 里的参数，你可以把这块音柱调教得更聪明：

调节音量：怕吵到人？先调低音量再播报。
- 在 order_payload 里加入 "volume": 5。
加个特效音：播报前先“叮”一声，提醒大家注意。
- 把 text_to_speak 改成 "[message_1] 您好，有客人来了"。官方内置了5种提示音（message_1 到 message_5）和5种警示音。
停止