怎么对接智能语音壁挂音箱|10W来实现语音提醒发送_解决方案

CATALOG

一、概述

芯步智能语音壁挂音箱（10W）提供标准的HTTP API接口，允许开发者通过简单的HTTP请求将文本内容实时合成为语音，在设备端进行播报。本文档详细介绍如何对接该设备实现语音提醒发送功能。

适用设备型号：UNI-YY-YX-BG-LAN-10W（有线网版）及相关款式

核心技术特点

芯片级TTS（文本转语音），在设备端完成语音合成
毫秒级响应速度，从命令下达到播报约80-120ms
无需预录语音，直接推送文本即可播放
支持公网和纯局域网环境，可私有化部署

二、对接前准备

2.1 获取API凭证

在开始对接前，需要完成以下步骤：

步骤	操作	说明
1	注册芯步账号	访问
2	创建工作台	在控制台创建新的工作台
3	获取AppID和AppSecret	在物联网控制台查看开发者凭证
4	获取设备ID	在控制台查看已绑定音箱的设备ID

2.2 设备准备

将智能语音壁挂音箱接通电源（DC 12V 2A）
确保设备已连接网络（有线或WiFi 2.4GHz）
在控制台确认设备状态为“在线”

三、API接口说明

3.1 接口基本信息

项目	说明
请求地址	`https://api.thingboot.com/{AppID}/device/control/`
请求方法	POST
Content-Type	application/json
鉴权方式	URL参数签名

3.2 签名算法

签名计算方式为双重MD5加密：

sign = MD5( MD5(AppSecret) + ts )

参数说明

AppSecret：开发者密码（在控制台获取）
ts：当前Unix时间戳（秒）
+：表示字符串拼接

计算示例（PHP）：

3.3 完整请求URL格式

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

四、核心功能实现

4.1 基础语音播报（文本转语音）

这是最核心的功能，直接推送文本即可让音箱播报。

请求示例

参数说明

device：设备唯一ID，支持多个设备用英文逗号分隔
order：命令对象，play:gbk:16为播报命令key，值为要播报的文本内容

4.2 带提示音的播报

在实际业务场景中，常常需要在播报内容前加入提示音以引起注意。

播报格式：在文本前添加 [message_X]，X为1-5的提示音编号

提示音编号对照

编号	效果
message_1	提示音1
message_2	提示音2
message_3	提示音3
message_4	提示音4
message_5	提示音5

4.3 数字读法控制

支持三种数字读法，适用于不同业务场景：

标记	用途	示例
[n1]	编号/ID读法（逐位朗读）	`ID为[n1]8888` → “八八八八”
[n2]	数值读法	`消费[n2]1888元` → “一千八百八十八”
[n3]	手机号读法	`电话[n3]13800138000` → “一三八零零一三八零零零”

示例

4.4 多音字处理

对于多音字，可使用 [=拼音] 标记指定读音：

4.5 停顿控制

标记	效果
[w0]	短停顿
[w1]	长停顿

五、设备管理命令

5.1 音量控制

音量范围为0-9级，其中9为最大音量。

5.2 音色切换

值	音色
0	女声（默认）
1	男声

5.3 语速调节

语速范围为0-9级，5为正常语速。

5.4 语调调节

语调范围为0-9级，5为正常语调。

5.5 内置铃声/提示音/警示音

各内置5种音效，编号1-5：

5.6 停止播报

值	效果
0	停止当前播报
1	停止全部播报

六、代码示例

6.1 Java实现

import okhttp3.*;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;

public class VoiceBroadcastService {
    private static final String APP_ID = "您的AppID";
    private static final String APP_SECRET = "您的AppSecret";
    
    public static void main(String[] args) throws Exception {
        long ts = System.currentTimeMillis() / 1000;
        String sign = generateSign(APP_SECRET, ts);
        
        String url = "https://api.thingboot.com/" + APP_ID + "/device/control/?sign=" + sign + "&ts=" + ts;
        
        OkHttpClient client = new OkHttpClient();
        
        String jsonBody = "{\"device\":\"820720\",\"order\":{\"play:gbk:16\":\"您有新的语音提醒\"}}";
        RequestBody body = RequestBody.create(jsonBody, MediaType.parse("application/json"));
        
        Request request = new Request.Builder()
                .url(url)
                .post(body)
                .build();
        
        Response response = client.newCall(request).execute();
        System.out.println(response.body().string());
    }
    
    private static String generateSign(String secret, long ts) throws NoSuchAlgorithmException {
        String md5Secret = md5(secret);
        String combined = md5Secret + ts;
        return md5(combined);
    }
    
    private static String md5(String input) throws NoSuchAlgorithmException {
        MessageDigest md = MessageDigest.getInstance("MD5");
        byte[] digest = md.digest(input.getBytes());
        StringBuilder sb = new StringBuilder();
        for (byte b : digest) {
            sb.append(String.format("x", b));
        }
        return sb.toString();
    }
}

6.2 Python实现

6.3 Shell脚本（curl）实现

七、业务场景集成方案

7.1 订单提醒场景

当系统产生新订单时，自动触发语音播报：

7.2 告警通知场景

监控系统检测到异常时推送告警：

7.3 工作流提醒场景

ERP/OA系统中的流程节点通知：

八、注意事项

文本长度限制：单次播报不超过50个字符，过长文本可分多条连续下发
响应速度：从命令下发到设备响应约为80-120ms，属于正常范围
网络环境：设备支持纯局域网运行，可将API地址配置为私有化部署地址
多设备广播device参数支持多个设备ID用英文逗号分隔，可实现群发
签名时效：时间戳ts用于签名，使用当前实时时间戳，避免因时间偏差导致鉴权失败

九、技术支持

芯步提供全程免费技术指导，包括：

设备选型咨询
接口对接支持
安装调试指导

可通过芯步官网联系技术支持团队。