图书馆自习室座位预约语音通知场景：怎么把智能 30W 壁挂远程控制语音音箱对接到自己的项目中_解决方案

CATALOG

一、这个场景能解决啥问题？

想象一下这个画面：学生小王在手机上预约了图书馆三楼靠窗的座位，快到点了，他正戴着耳机在书架间找书。这时候，墙上的智能音箱突然播报：“同学你好，您预约的A区12号座位将在15分钟后失效，请尽快扫码签到。”——这就是我们今天要做的。

芯步的智能30W壁挂远程控制语音音箱（就是他们官网上的“智能语音壁挂音箱|款式1”），本质上是个能联网的“嘴巴”。只要给它一个HTTP请求，告诉它要说什么，它就能开口。把它跟你的座位预约系统打通，就能实现“预约状态变化 → 自动语音提醒”的闭环。

二、准备工作：你需要拿到这三样东西

在动手写代码之前，先去芯步的开放平台（）完成这几步：

注册开发者账号，创建一个应用。完成后你会得到两个关键字符串：
- AppID：你的应用ID，相当于用户名
- AppSecret：你的应用密钥，打死也不能写在代码里暴露出去
给音箱配网并拿到设备ID。把音箱通电，按说明配好WiFi。然后在控制台的设备列表里找到它，会有一个类似 1878 或 "gtyVWcgcig" 这样的 device 值。这个就是音箱的“身份证号”。
确认设备在线。在控制台看一眼设备状态，online.status 为 1 就说明它已经连上网了。

三、核心接口：怎么让音箱“开口说话”？

芯步的设备控制接口地址是：

最关键的其实是 order 参数里的命令格式。对于语音播报类设备，播报命令长这样

那个 gbk 是编码格式，16 是音量（范围大概0到100），你也可以换成其他音量和编码。支持中文直接传，不用提前录录音文件，这点很方便。

小提示：命令格式一定要跟官方文档核对清楚。不同产品类型的设备命令不一样，智能插座的 {"power1":1} 可没法让音箱说话。

四、代码实战：用Python快速实现

考虑到很多图书馆的后端是用Python写的，我这里就用 requests 库来演示。其他语言（Java、Go）原理完全一样，只是签名算法和HTTP库的写法不同。

第一步：写一个音箱控制函数

import hashlib
import time
import requests

def play_voice(device_id, text, volume=16):
    """
    让芯步智能音箱播报一段文字
    :param device_id: 音箱的设备ID
    :param text: 要播报的文本内容（中文OK）
    :param volume: 音量，0-100左右，默认16
    """
    AppID = "你的AppID"          # 替换成真的
    AppSecret = "你的AppSecret"  # 替换成真的，别暴露！
    
    # 1. 生成时间戳（秒级）
    ts = int(time.time())
    
    # 2. 生成签名:md5(md5(AppSecret) + ts)
    #    官网文档明确是这个算法[citation:2][citation:4]
    md5_first = hashlib.md5(AppSecret.encode()).hexdigest()
    sign_str = md5_first + str(ts)
    sign = hashlib.md5(sign_str.encode()).hexdigest()
    
    # 3. 拼接口URL
    url = f"https://api.thingboot.com/{AppID}/device/control/"
    params = {
        "sign": sign,
        "ts": ts
    }
    
    # 4. 构造命令:关键就是这个order的格式
    #    让音箱播报，编码用gbk，音量默认16[citation:2]
    order = {f"play:gbk:{volume}": text}
    payload = {
        "device": device_id,
        "order": order
    }
    
    # 5. 发送POST请求
    headers = {"Content-Type": "application/json"}
    try:
        response = requests.post(url, params=params, json=payload, headers=headers, timeout=5)
        result = response.json()
        if result.get("code") == 200:
            print(f"✅ 播报成功:{text}")
        else:
            print(f"❌ 播报失败:{result.get('msg')}")
        return result
    except Exception as e:
        print(f"❌ 网络请求异常:{e}")
        return None

第二步：集成到座位预约系统里

假设你的预约系统已经有这些能力：用户预约、取消、签到、临时离开……那么在关键的状态变更节点，加上语音通知的逻辑就行。

场景1：预约成功时，只通知用户本人

可以只播报到离他最近的音箱（这需要系统里有“座位ID → 音箱设备ID”的映射关系）：