活动现场语音提示：怎么把10W壁挂语音通知音箱集成到自己的项目中_解决方案

CATALOG

芯步10W壁挂音箱采用标准HTTP接口，单次播报请求即可触发TTS语音，无需预录音频。以下方案涵盖接口对接流程、签名算法和典型活动场景的命令示例，开发者可在1小时内完成基础集成。

一、解决概述

对于需要 “活动现场语音提示” 的场景（如展会抽奖、商场促销、车间报工），核心需求是低延迟和高并发下的稳定播报。

芯步的 10W 壁挂语音通知音箱 支持 设备端TTS（文字转语音） 。你的系统只需要通过HTTP POST请求发送文字内容，音箱内部芯片会立即合成语音并播放，响应时间通常在 80-120ms 内。

本方案将指导你通过 3 个步骤 完成集成：设备配网 -> 获取密钥 -> 发送播报指令。

二、集成前的准备

在开始编码前，你需要准备以下 3 个关键信息，这些信息在芯步控制台的后台可以获取：

AppID：你的应用唯一标识。
AppSecret：用于生成接口签名（Sign）的密钥。
Device ID：音箱底部的标签或配网后在后台查看到的设备编号。

三、接口集成方案

音箱的开放接口基于 HTTP 协议，这意味着无论你的后台使用的是 Java、Python、PHP 还是前端 JavaScript（通过Node.js或云函数），都可以轻松接入。

1. 核心接口地址

[HTTP方法] POST
[请求地址] http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
[Content-Type] application/json

2. 签名生成规则

为了防止接口被恶意调用，需要对请求进行签名。生成规则相对简单：Sign = md5( md5(AppSecret) + ts )。

ts：当前的 UNIX 时间戳（秒）。
注意：是将 AppSecret 做了一次 MD5 加密后的字符串与时间戳拼接，再做一次 MD5。

3. 请求体参数

针对 10W 壁挂音箱，下发语音播报的 order 格式如下：

参数名	是否必填	类型	描述
device	是	String	音箱的设备ID
order	是	Object	指令集
└ play:gbk:16	是	String	核心指令：要播报的文本内容

四、实战代码演示

以下是一个针对“活动现场”场景的 PHP 集成示例，核心逻辑展示了如何动态生成签名并下发“欢迎张三”或“抽奖提醒”等指令。

<?php
// 1. 配置你的秘钥信息
$AppId = "YOUR_APP_ID";          // 后台获取的AppId
$AppSecret = "YOUR_APP_SECRET";  // 后台获取的AppSecret
$deviceId = "820720";            // 你的10W音箱设备ID

// 2. 构造签名 (Sign)
$ts = time();                                                    // 当前时间戳
$sign = md5(md5($AppSecret) . $ts);                             // 签名算法

// 3. 构造请求URL
$url = "https://api.thingboot.com/{$AppId}/device/control/?sign={$sign}&ts={$ts}";

// 4. 构造指令 (例如:活动现场播报)
$order = [
    "play:gbk:16" => "恭喜编号零零壹用户，获得本次活动一等奖"  // 直接传中文文本
];

$postData = json_encode([
    "device" => $deviceId,
    "order" => $order
]);

// 5. 发送请求 (使用cURL)
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Content-Length: ' . strlen($postData)
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

// 6. 判断结果
if ($httpCode == 200) {
    echo "语音指令已下达，音箱即将播报";
} else {
    echo "下发失败，请检查签名或设备网络状态";
}
?>

五、进阶与扩展：让你的活动更智能

10W音箱不仅支持单纯文字播报，还提供了丰富的控制参数，你可以根据需要灵活组合。

预设第一种场景：循环叫号提醒

在长时间排队活动中，你可以利用 repeat 参数实现循环播放：

预设第二种场景：播放前“叮”一声提示

为了吸引注意力，可以在播报前加入提示音 message

预设第三种场景：调整音量适应环境

现场环境嘈杂时，可通过 volume 调整音量（0-9级，9为最大）：

六、常见问题与排障（FAQ）

报错 502/503 怎么办
- 502：代表设备ID不存在。请检查 Device ID 是否填错，或者音箱是否已被删除。
- 503：代表指定了过多设备或设备不可用。
下发成功但音箱没声音
- 接口返回 200 代表指令已到达云端，仅代表设备在线且指令格式正确。如果没声音，请检查音箱的物理开关是否打开，或者当前音量 volume 是否设置为 0 。
文本支持英文和数字吗
- 支持。芯片级TTS会自动识别，但对于金额（如 100元）和手机号（如 1XX...）的读法，在代码中做好格式整理，或者利用接口参数指定读法。
必须在互联网环境吗
- 不需要。10W音箱支持 私有化部署 。如果你的活动现场是一个封闭的局域网（无外网），可以将API地址指向部署在局域网内的私有云服务，同样能实现上述控制功能。

通过以上方案，你可以将10W壁挂语音通知音箱像调用普通 API 一样集成到自己的活动管理、票务或自动化系统中，实现即时、响亮的现场语音互动。