调度站语音提示：怎么把智能语音音柱|60W集成到自己的项目中_解决方案

CATALOG

一、概述

调度站（车站、公交场站、港口、工厂物流中心等）是信息传达的核心枢纽，需要及时向工作人员和流动人员传递车次安排、安全提示、应急疏散等语音指令。芯步60W智能语音音柱专为大型调度站、广场、车间等高噪音、大范围覆盖场景设计，通过HTTP接口实现文本实时播报，从根本上解决了传统广播需提前录音、响应慢、部署复杂等痛点。

核心能力

60W超大功率：专为调度站、车站、港口等高噪音户外环境定制
芯片级TTS：文本到语音在设备端合成，80-120ms毫秒级响应
多种联网方式：支持WiFi版和有线网版，适应不同网络环境
开放HTTP API：无需上传录音，直接推送文本即可播报
私有化部署：支持局域网运行，数据不出站点内网
无网关设计：设备直连网络，可设定5组WiFi自动切换

二、产品核心特性

2.1 60W智能语音音柱规格

芯步60W智能语音音柱提供两种联网版本，可根据现场网络条件灵活选择

特性	WiFi版（UNI-YY-YZ-60W）	有线网版（UNI-YY-YZ-60W-LAN）
功率	60W	60W
联网方式	WiFi 2.4GHz	以太网 + WiFi（双网备份）
外壳材质	铝合金，分隔式绝缘隔断	同左
产品尺寸	长150mm 宽100mm 高335mm	长150mm 宽100mm 高335mm
产品净重	1.5KG	1.5KG
控制接口	HTTP API	HTTP API
私有化部署	支持	支持
工作电压	DC 12V	DC 12V

2.2 调度站典型应用场景

场景	触发条件	语音内容示例
车辆进出站	调度系统派发车次	“G1002次列车即将进站，请工作人员接车”
发车提醒	发车时间到达	“开往市中心的101路公交车即将发车”
安全提示	定时/事件触发	“请勿在站台吸烟，注意与列车保持安全距离”
紧急疏散	安全事件触发	“紧急通知，请所有人员有序疏散至安全区域”
调度指令	调度人员操作	“3号站台，请开始检票”

2.3 设备核心优势

开放HTTP接口：适用于任何支持HTTP请求的编程语言，Web、APP/小程序、SaaS/低代码平台均可接入
私有化部署：支持自建消息服务器，可运行在纯局域网环境
网络冗余：有线网版支持以太网+WiFi双网备份，确保播报不中断
超低延迟：命令下发到设备响应80-120ms

三、整体架构

3.1 架构图

┌─────────────────────────────────────────────────────────────────┐
│                    调度站管理系统 / 调度平台                      │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐               │
│  │  班次看板   │  │  调度控制台  │  │  告警中心   │               │
│  └─────────────┘  └─────────────┘  └─────────────┘               │
└─────────────────────────────────────────────────────────────────┘
                              ▲
                              │ HTTP API调用（携带签名）
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                     芯步云平台 / 私有化服务器                  │
└─────────────────────────────────────────────────────────────────┘
                              ▲
                              │ WiFi / 有线网络
          ┌───────────────────┼───────────────────┐
          │                   │                   │
          ▼                   ▼                   ▼
    ┌──────────┐       ┌──────────┐       ┌──────────┐
    │ 进站口   │       │ 候车厅   │       │ 调度室   │
    │ 60W音柱  │       │ 60W音柱  │       │ 60W音柱  │
    └──────────┘       └──────────┘       └──────────┘

3.2 集成工作流程

业务触发：调度系统产生事件（发车时间到、安全事件、紧急情况等）
文本生成：系统根据事件类型和参数生成播报文本
签名计算：生成MD5签名，发起一个HTTP请求
指令下发：向API发送POST请求
设备播报：音柱接收命令，芯片级TTS实时合成并播放（80-120ms）

四、API接口接入详解

4.1 接口地址与签名计算

请求地址

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

参数说明

参数	说明	示例
{AppId}	应用ID（控制台获取）	`qtyVWcgeMq`
{ts}	当前Unix时间戳（秒）	`1747212640`
{sign}	签名（见下方计算公式）	`c484eb97...`

签名计算公式

sign = md5( md5(AppSecret) + ts )

将开发者密码（AppSecret）进行一次MD5
将这个结果拼接上时间戳ts
对整个拼接后的字符串再做一次MD5

签名计算示例

4.2 核心命令详解

4.2.1 基本文本播报

4.2.2 带提示音的播报

适用于重要通知，增强提醒效果：

4.2.3 紧急播报（最大音量+警示音）

4.2.4 音量调节

*音量范围：0-9（0静音，9最大）*

4.2.5 音色切换

*0=女声，1=男声*

4.2.6 语速调节

*语速范围：0-9*

4.2.7 停止当前播报

4.2.8 批量播报（多个音柱）

五、多语言代码示例

5.1 Python

import requests
import time
import hashlib

class DispatchStationSpeaker:
    """调度站语音音柱控制器"""
    
    def __init__(self, app_id, app_secret):
        self.app_id = app_id
        self.app_secret = app_secret
        self.base_url = f"https://api.thingboot.com/{app_id}/device/control/"
    
    def _generate_sign(self, ts):
        """生成签名:md5(md5(AppSecret) + ts)"""
        md5_secret = hashlib.md5(self.app_secret.encode()).hexdigest()
        sign_str = md5_secret + str(ts)
        return hashlib.md5(sign_str.encode()).hexdigest()
    
    def _send_command(self, device_id, order):
        """发送命令到设备"""
        ts = int(time.time())
        sign = self._generate_sign(ts)
        
        url = f"{self.base_url}?sign={sign}&ts={ts}"
        payload = {"device": device_id, "order": order}
        
        response = requests.post(url, json=payload)
        return response.json()
    
    def broadcast(self, device_id, text, volume=None, voice=None, speed=None):
        """语音播报"""
        order = {"play:gbk:16": text}
        if volume:
            order["volume"] = str(volume)
        if voice:
            order["voice"] = str(voice)
        if speed:
            order["speed"] = str(speed)
        return self._send_command(device_id, order)
    
    def emergency_broadcast(self, device_id, text):
        """紧急播报（警示音+最大音量）"""
        order = {
            "play:gbk:16": f"[alert_1]{text}",
            "volume": "9"
        }
        return self._send_command(device_id, order)
    
    def train_arrival(self, device_id, train_no, platform):
        """列车到站播报"""
        text = f"{train_no}次列车即将进站，请停靠{platform}号站台"
        return self.broadcast(device_id, text, volume=7)
    
    def train_departure(self, device_id, train_no, destination):
        """列车发车播报"""
        text = f"开往{destination}的{train_no}次列车即将发车，请乘客抓紧时间上车"
        return self.broadcast(device_id, text, volume=7)
    
    def batch_broadcast(self, device_ids, text):
        """批量播报"""
        devices_str = ",".join(device_ids)
        return self.broadcast(devices_str, text)

# 使用示例
speaker = DispatchStationSpeaker("your_app_id", "your_app_secret")

# 列车到站提醒
speaker.train_arrival("speaker_platform_01", "G1002", "3")

# 紧急疏散
speaker.emergency_broadcast("speaker_waiting_hall", "因突发情况，请所有人员有序疏散")

# 全站批量播报
speaker.batch_broadcast(
    ["speaker_01", "speaker_02", "speaker_03"], 
    "全站通知，所有列车运行正常"
)

5.2 Java

import okhttp3.*;
import java.security.MessageDigest;
import java.time.Instant;

public class DispatchStationSpeaker {
    private final String appId;
    private final String appSecret;
    private final OkHttpClient client;
    private static final MediaType JSON = MediaType.parse("application/json; charset=utf-8");
    
    public DispatchStationSpeaker(String appId, String appSecret) {
        this.appId = appId;
        this.appSecret = appSecret;
        this.client = new OkHttpClient();
    }
    
    private String md5(String input) {
        try {
            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();
        } catch (Exception e) {
            throw new RuntimeException(e);
        }
    }
    
    private String generateSign(long ts) {
        String md5Secret = md5(appSecret);
        return md5(md5Secret + ts);
    }
    
    public String broadcast(String deviceId, String text, Integer volume) throws Exception {
        long ts = Instant.now().getEpochSecond();
        String sign = generateSign(ts);
        String url = String.format("https://api.thingboot.com/%s/device/control/?sign=%s&ts=%d", 
            appId, sign, ts);
        
        Map<String, Object> order = new HashMap<>();
        order.put("play:gbk:16", text);
        if (volume != null) {
            order.put("volume", volume.toString());
        }
        
        Map<String, Object> payload = new HashMap<>();
        payload.put("device", deviceId);
        payload.put("order", order);
        
        String jsonPayload = new Gson().toJson(payload);
        RequestBody body = RequestBody.create(jsonPayload, JSON);
        Request request = new Request.Builder().url(url).post(body).build();
        
        Response response = client.newCall(request).execute();
        return response.body().string();
    }
}

5.3 JavaScript/Node.js

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

class DispatchStationSpeaker {
    constructor(appId, appSecret) {
        this.appId = appId;
        this.appSecret = appSecret;
        this.baseUrl = `https://api.thingboot.com/${appId}/device/control/`;
    }
    
    _generateSign(ts) {
        const md5Secret = crypto.createHash('md5').update(this.appSecret).digest('hex');
        const signStr = md5Secret + ts;
        return crypto.createHash('md5').update(signStr).digest('hex');
    }
    
    async broadcast(deviceId, text, options = {}) {
        const ts = Math.floor(Date.now() / 1000);
        const sign = this._generateSign(ts);
        const url = `${this.baseUrl}?sign=${sign}&ts=${ts}`;
        
        const order = { "play:gbk:16": text };
        if (options.volume) order.volume = options.volume.toString();
        if (options.voice) order.voice = options.voice.toString();
        
        const payload = { device: deviceId, order };
        const response = await axios.post(url, payload);
        return response.data;
    }
    
    async batchBroadcast(deviceIds, text) {
        const deviceStr = deviceIds.join(',');
        return this.broadcast(deviceStr, text);
    }
}

5.4 Shell（curl）- 快速测试

代码参考：

六、调度站场景实战

6.1 第一种场景：列车到站自动播报

需求：调度系统列车到站信息自动触发语音播报，通知旅客和工作人员。

设备配置：每个站台部署1台60W音柱（WiFi版或有线网版）

6.2 第二种场景：全站紧急疏散广播

需求：火灾等紧急情况时，触发全站所有音柱立即播报疏散指令。

设备配置：全站部署的所有60W音柱

6.3 第三种场景：定时安全广播

需求：定时播报安全提示信息。

设备配置：候车厅音柱

6.4 场景四：与调度系统Webhook集成

需求：调度操作台一键触发语音播报。

6.5 场景五：多音柱分区播报管理

需求：大型枢纽站按区域分发音柱，实现分区独立播报。

class ZoneBroadcastManager:
    """分区广播管理器"""
    
    def __init__(self, speaker):
        self.speaker = speaker
        self.zones = {
            "entrance": ["speaker_entrance_01", "speaker_entrance_02"],
            "platform_1": ["speaker_p1_01", "speaker_p1_02"],
            "platform_2": ["speaker_p2_01", "speaker_p2_02"],
            "waiting_hall": ["speaker_hall_01", "speaker_hall_02"],
            "dispatch_room": ["speaker_dispatch_01"]
        }
    
    def zone_broadcast(self, zone_name, text, emergency=False):
        """指定区域播报"""
        device_ids = self.zones.get(zone_name, [])
        if device_ids:
            if emergency:
                for device_id in device_ids:
                    self.speaker.emergency_broadcast(device_id, text)
            else:
                self.speaker.batch_broadcast(device_ids, text)
    
    def all_zones_broadcast(self, text, emergency=False):
        """全站播报"""
        for zone_name, device_ids in self.zones.items():
            self.zone_broadcast(zone_name, text, emergency)

七、私有化部署方案

调度站对系统稳定性和数据安全要求较高，芯步60W音柱支持纯局域网运行，无需依赖外网。

部署模式对比

特性	公有云模式	私有化模式
设备联网	WiFi连接互联网	连接内网WiFi/有线
API地址	`api.thingboot.com`	自建服务器IP
数据流向	经过芯步云端	内网直连，数据不出站
网络依赖	需要互联网	仅需局域网
适用场景	快速接入、小型站场	大型枢纽、安全合规要求高

私有化配置要点

设备支持配置5组WiFi网络，自动连接信号最强的网络
有线网版可优先使用以太网，WiFi作为备用
需自建HTTP服务，所有API调用在内网完成
支持自建消息服务器，接收设备状态回调

八、设备安装部署指南

8.1 安装要求

项目	要求
安装方式	壁挂或抱杆安装
安装高度	距地面2.5-3.5米，声音传播覆盖最佳
供电方式	DC 12V（产品附带电源适配器）
网络要求	WiFi 2.4GHz信号（WiFi版）或网线（有线版）
外壳材质	铝合金，分隔式绝缘隔断，防止漏电风险

8.2 部署位置

调度站类型	部署数量	安装位置
公交枢纽站（小型）	3-5台	候车区、发车区、调度室
长途客运站	6-10台	各站台、候车厅、售票厅
火车站/高铁站	10+台	候车室、检票口、站台
港口调度站	5-8台	泊位区、调度中心、堆场

8.3 有线版网络配置

有线网版（UNI-YY-YZ-60W-LAN）支持：

以太网优先连接，确保网络稳定
WiFi作为备用网络，自动切换

九、常见问题与排障

问题	可能原因	解决方案
设备不在线	网络连接问题	检查网络连接，设备支持5组WiFi自动切换
播报延迟高	网络波动	私有化部署可降至80-120ms
音量不够大	环境噪音大	调高volume至9，60W功率已覆盖大部分户外场景
多音字读错	TTS引擎规则	使用同音字替代策略
签名验证失败	参数错误	确保ts为秒级时间戳，签名公式为`md5(md5(AppSecret)+ts)`
无法同时播报	设备正在播报	使用`stop`命令停止当前播报后再发新命令
有线版无法联网	网线接口问题	检查网线连接，设备支持DHCP自动获取IP

十、总结

本方案基于芯步60W智能语音音柱，实现了调度站的自动化语音播报与软件无缝集成

能力	实现的方式是
列车到站/发车播报	调度系统事件驱动HTTP API
紧急疏散广播	安全事件触发紧急播报模式
定时安全广播	定时任务自动触发
分区独立播报	按区域部署多台音柱，分别控制
全站统一广播	批量控制命令，单次触发全部
有线+无线双网备份	有线网版支持以太网+WiFi冗余

集成核心步骤

获取AppID/AppSecret，实现MD5签名计算
开发HTTP调用模块，封装播报、音量调节等命令
根据站场布局，设置设备ID与站台/区域的映射
在调度管理系统中，在业务事件中调用播报接口

方案优势

✅ 超大功率：60W输出，覆盖调度站、车站、港口等高噪音场景
✅ 双版本可选：WiFi版灵活部署，有线网版网络更稳定
✅ 接口统一：标准HTTP API，任意编程语言10分钟对接
✅ 超低延迟：80-120ms响应，实时性强
✅ 私有化部署：支持局域网运行，数据安全可控
✅ 网络冗余：有线网版支持以太网+WiFi双网备份

如需详细的产品手册和API文档，请访问查阅或联系技术支持团队获取。