展会现场语音播报：怎样把智能 20W 云控制语音音柱接入到项目中_解决方案

CATALOG

一、背景与需求分析

在大型展会场景中，主办方面临着多展位、多语种、多批次观众的复杂信息播报需求。传统的广播系统存在布线困难、分区僵化、内容更新繁琐等痛点，而人工引导又难以保证覆盖面和一致性。芯步推出的智能20W云控制语音音柱（型号UNI-YY-YZ-20W），凭借其开放的HTTP接口和灵活的部署方式，为展会现场语音播报提供了高效、低成本的解决方案。

该设备具备以下核心优势：

无需网关，WiFi直连：设备使用2.4G WiFi网络，支持设定5组WiFi并自动切换至信号最强的网络
芯片级TTS合成：设备端完成文本转语音，毫秒级响应，支持男/女声、语速、语调、音量调节
全面开放HTTP接口：支持任何编程语言调用，可接入Web、小程序、SaaS平台等
私有化部署能力：支持自建消息服务器，可在纯局域网环境运行

本文档旨在指导系统集成商和开发人员，将芯步智能20W语音音柱快速接入展会管理系统中。

二、整体设计

2.1 网络拓扑架构

展会现场的网络环境通常较为复杂，采用以下架构：

┌─────────────────────────────────────────────────────────┐
│                      展会管理系统                          │
│  ┌─────────┐  ┌─────────┐  ┌─────────┐                  │
│  │ 签到系统 │  │ 调度中心 │  │ 导览APP │                  │
│  └────┬────┘  └────┬────┘  └────┬────┘                  │
│       └────────────┼────────────┘                        │
│                    ▼                                      │
│            ┌───────────────┐                             │
│            │  业务服务端    │                             │
│            │ (播报调度引擎) │                             │
│            └───────┬───────┘                             │
└────────────────────┼─────────────────────────────────────┘
                     │ HTTP/HTTPS
                     ▼
            ┌───────────────┐
            │  api.thingboot.com│  ← 公网模式
            │  或自建MQTT    │  ← 局域网模式（私有化）
            └───────┬───────┘
                     │
            ┌────────┴────────┐
            │  展会现场WiFi    │
            └────────┬────────┘
                     │
     ┌───────────────┼───────────────┐
     ▼               ▼               ▼
┌─────────┐    ┌─────────┐    ┌─────────┐
│ 音柱A    │    │ 音柱B    │    │ 音柱N    │
│展位A播报 │    │展位B播报 │    │通道播报 │
└─────────┘    └─────────┘    └─────────┘

2.2 设备选型说明

针对展会现场的大空间覆盖需求，20W智能语音音柱是合适的选择：

功率：20W，适合100-200㎡的展位或通道覆盖
防护等级：防尘防水，适用于展会临时搭建环境
连接方式：可选纯WiFi版或WiFi+以太网版（UNI-YY-YZ-20W-LAN）
响应速度：80-120ms从命令下发到设备响应

三、设备接入流程

3.1 设备配网与初始化

步骤一：设备上电将音柱接入12V/3A电源，设备自动启动，等待约30秒进入待机状态。待机功耗低于2W。

步骤二：WiFi配置通过芯步官方提供的配网工具（微信小程序或PC工具），将设备接入展会现场WiFi：

支持2.4GHz频段（不支持5G）
可配置5组备用WiFi，设备自动选择信号最强的网络连接

步骤三：获取设备ID配网成功后，在芯步控制台中获取设备的唯一标识符（device ID），该ID用于后续接口调用。设备ID格式为数字串，如820720。

3.2 接口认证准备

在调用API前，需准备以下凭证：

参数	说明	获取方式
AppId	应用唯一标识	芯步控制台“开发设置”中获取
AppSecret	应用密钥	同上，需妥善保管

签名算法（关键步骤）：

ts = 当前Unix时间戳（秒）
sign = MD5( MD5(AppSecret) + ts )

签名计算示例（伪代码）：

1. step1 = MD5(AppSecret)           # 第一次MD5
2. step2 = step1 + ts                # 拼接时间戳
3. sign = MD5(step2)                 # 第二次MD5

四、核心接口调用实现

4.1 接口基本信息

请求地址http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
请求方法：POST
数据格式：JSON
Content-Typeapplication/json

4.2 基础播报命令

请求体示例

字段说明

device：设备ID，支持多个设备用逗号分隔，如"820720,820721"
order：命令对象，key为命令类型，value为命令参数
play:gbk:16：播报命令，16表示音量等级（0-9级，此处16为兼容写法实际为0-9）

4.3 高级播报配置

展会场景中，往往需要根据不同时段和展位需求调整播报效果：

音量控制

音色切换

语速调节

播放提示音

4.4 展会场景完整示例

在展会入口处播报综合信息：

五、多语言与代码示例

芯步的HTTP接口支持任何能够发起HTTP请求的编程语言。以下提供几种常见语言的对接范式。

5.1 Java实现（使用Unirest）

import com.konghq.unirest.http.HttpResponse;
import com.konghq.unirest.http.Unirest;
import org.apache.commons.codec.digest.DigestUtils;

public class AudioBroadcastService {
    
    private String appId;
    private String appSecret;
    
    public AudioBroadcastService(String appId, String appSecret) {
        this.appId = appId;
        this.appSecret = appSecret;
    }
    
    private String generateSign(long ts) {
        String md5Secret = DigestUtils.md5Hex(appSecret);
        return DigestUtils.md5Hex(md5Secret + ts);
    }
    
    public boolean broadcast(String deviceId, String text, int volume) {
        long ts = System.currentTimeMillis() / 1000;
        String sign = generateSign(ts);
        
        String url = String.format("https://api.thingboot.com/%s/device/control/?sign=%s&ts=%s", 
                                    appId, sign, ts);
        
        String orderJson = String.format("{\"play:gbk:%d\":\"%s\"}", volume, text);
        String requestBody = String.format("{\"device\":\"%s\",\"order\":%s}", deviceId, orderJson);
        
        HttpResponse<String> response = Unirest.post(url)
                .header("Content-Type", "application/json")
                .body(requestBody)
                .asString();
        
        return response.getStatus() == 200;
    }
}

5.2 Node.js实现

const crypto = require('crypto');
const axios = require('axios');

class AudioBroadcast {
    constructor(appId, appSecret) {
        this.appId = appId;
        this.appSecret = appSecret;
    }
    
    generateSign(ts) {
        const md5Secret = crypto.createHash('md5').update(this.appSecret).digest('hex');
        return crypto.createHash('md5').update(md5Secret + ts).digest('hex');
    }
    
    async broadcast(deviceId, text, volume = 7) {
        const ts = Math.floor(Date.now() / 1000);
        const sign = this.generateSign(ts);
        
        const url = `https://api.thingboot.com/${this.appId}/device/control/?sign=${sign}&ts=${ts}`;
        
        const data = {
            device: deviceId,
            order: { [`play:gbk:${volume}`]: text }
        };
        
        const response = await axios.post(url, data, {
            headers: { 'Content-Type': 'application/json' }
        });
        
        return response.data;
    }
}

// 使用示例
const announcer = new AudioBroadcast('YOUR_APP_ID', 'YOUR_APP_SECRET');
await announcer.broadcast('820720', 'A区3号展位将在10分钟后进行产品演示');

5.3 Python实现

六、展会场景最佳实践

6.1 多音柱分区播报

展会通常有多个区域，为每个展区/通道配置独立音柱：

设备ID	部署位置	播报职责
820720	A区入口	入场指引、安全须知
820721	主论坛区	议程提醒、嘉宾介绍
820722	B区展位区	展商活动通知
820723	C区洽谈区	会议预约提醒

通过多设备ID并发调用，可实现分区独立控制：

6.2 紧急播报打断机制

当发生紧急情况需要插播时，可使用打断功能：

6.3 定时播报调度

结合展会管理系统的定时任务功能，可预设全天播报计划：

典型日程安排

09:55 - 暖场音乐/温馨提示
10:00 - 展会开幕欢迎词
11:00 - 主论坛议程提醒
12:00 - 午餐时段指引
14:00 - 下午场开始提示
16:50 - 闭馆倒计时通知

6.4 稳定性保障

1. 网络冗余设计：设备支持配置5组WiFi，将展会现场多个AP的SSID均配置到设备中，实现自动漫游。

2. 私有化部署：若展会现场无公网或对稳定性要求比较高，可选择私有化部署方案，自建消息服务器，API地址替换为内网地址。

3. 设备状态监控：在管理系统中记录每次接口调用的响应状态，对异常情况（如设备离线）设置告警机制。

七、总结

芯步智能20W云控制语音音柱通过标准化的HTTP接口，大幅降低了展会现场语音播报系统的集成门槛。核心技术要点可概括为：

接入简单：设备配网后即可通过HTTP接口调用，无需网关中转
响应快速：端到端延迟80-120ms，满足实时播报需求
控制灵活：支持音量、音色、语速、语调等多维度调节
部署多样：支持公网和局域网两种模式，适配不同展会环境

通过本文档提供的设计和代码示例，集成商可快速将语音音柱能力整合到展会管理系统中，为参展观众提供清晰、及时的语音导览服务。