写字楼大厅语音播报场景：怎么把智能 60W 云控制语音音柱对接到软件项目中_解决方案

CATALOG

一、场景需求概述

写字楼大厅是人员流动密集、信息通知需求多样的场所。传统的人工广播方式存在效率低、及时性差、内容单一等问题。通过将芯步智能60W云控制语音音柱（型号：UNI-YY-YZ-PRO-60W）对接至现有软件项目，可实现访客接待、快递通知、会议提醒、紧急广播等场景的自动化语音播报。

该音柱具备60W大功率输出，覆盖面积广，适用于开放式大厅环境。其核心优势在于开放HTTP接口，任何支持HTTP请求的编程语言均可调用，无需专有硬件网关，设备通过WiFi 2.4G直连网络，即插即用。

二、整体设计

2.1 网络拓扑架构

┌─────────────────┐      ┌─────────────────┐      ┌─────────────────┐
│   软件项目       │      │   芯步云平台  │      │   智能语音音柱    │
│ (OA/ERP/小程序)  │ ───▶ │  api.thingboot.com │ ───▶ │  (UNI-YY-YZ-    │
│                 │ HTTP │                 │ MQTT │   PRO-60W)      │
└─────────────────┘      └─────────────────┘      └─────────────────┘
        │                                                        │
        │                        ┌─────────────────┐             │
        └───────────────────────▶│   局域网/私有化   │◀────────────┘
                                 │   自建服务器      │
                                 └─────────────────┘

2.2 数据流向

阶段	发起方	动作	协议	说明
播报触发	软件项目	发送HTTP请求	HTTPS	携带签名、设备ID、播报内容
指令转发	云平台	透传指令至设备	MQTT	平台与设备保持长连接
状态回传	音柱	上报播报状态	MQTT	可选，通过消息推送实现

该架构支持公网与私有化两种部署模式。公网模式下，软件项目通过芯步开放API下发指令；私有化模式下，企业可自建消息服务器，设备在纯局域网内运行，数据不外流。

三、对接核心流程

3.1 准备工作

对接前需完成以下配置：

注册开发者账号：登录芯步开放平台（），进入控制台创建应用
获取凭证：记录应用的AppID和AppSecret
添加设备：在控制台绑定音柱设备，获取设备唯一ID（Device ID）
网络配置：为音柱配置写字楼的WiFi网络（支持5组WiFi自动切换，优先连接信号最强网络）

3.2 签名计算机制

芯步采用双重MD5签名机制保障接口安全，所有控制请求必须在URL参数中携带签名和时间戳

签名算法 = md5( md5(AppSecret) + ts )

参数说明

AppSecret：开发者密码，在控制台获取
ts：当前Unix时间戳（秒级）
md5()：32位小写MD5加密

计算示例

AppSecret = "abc123xyz"
md5(AppSecret) = "5d41402abc4b2a76b9719d911017c592"
ts = 1704067200
拼接字符串 = "5d41402abc4b2a76b9719d911017c5921704067200"
最终签名 = md5(拼接字符串) = "c484eb97ee288572db7828c6071dd88f"

3.3 接口调用规范

请求地址

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

请求头

参数	值	必填
Content-Type	application/json	是

请求体参数

参数	类型	说明	示例
device	string	设备唯一ID，多个用逗号分隔	"123456"
order	object	下发命令的JSON对象	{"play:gbk:16":"欢迎光临"}

3.4 核心播报命令

音柱支持多种播报模式，以order字段的JSON对象传递

基础文本播报

带提示音的播报（message_3为提示音编号，取值1-5）：

控制播报

音量调节（音量范围0-9）：

音色切换（0女声/1男声）：

停止当前播报（1为全部停止）：

四、代码集成示例

4.1 Java（Spring Boot）集成

使用Unirest或RestTemplate实现HTTP调用

import kong.unirest.HttpResponse;
import kong.unirest.Unirest;
import org.apache.commons.codec.digest.DigestUtils;

public class VoiceBroadcastService {
    
    private static final String APP_ID = "your_app_id";
    private static final String APP_SECRET = "your_app_secret";
    private static final String DEVICE_ID = "your_device_id";
    private static final String API_URL = "https://api.thingboot.com/" + APP_ID + "/device/control/";
    
    /**
     * 发送语音播报
     * @param text 播报文本
     * @return 是否成功
     */
    public boolean broadcast(String text) {
        long ts = System.currentTimeMillis() / 1000;
        String sign = generateSign(ts);
        
        String url = API_URL + "?sign=" + sign + "&ts=" + ts;
        
        // 构建播报命令
        Map<String, Object> order = new HashMap<>();
        order.put("play:gbk:16", "[message_3]" + text);
        
        Map<String, Object> body = new HashMap<>();
        body.put("device", DEVICE_ID);
        body.put("order", order);
        
        HttpResponse<String> response = Unirest.post(url)
            .header("Content-Type", "application/json")
            .body(JSON.toJSONString(body))
            .asString();
        
        return response.getStatus() == 200;
    }
    
    /**
     * 生成签名:md5(md5(secret) + ts)
     */
    private String generateSign(long ts) {
        String md5Secret = DigestUtils.md5Hex(APP_SECRET);
        String signStr = md5Secret + ts;
        return DigestUtils.md5Hex(signStr);
    }
    
    /**
     * 调节设备音量
     * @param volume 0-9
     */
    public boolean setVolume(int volume) {
        // 参数校验
        if (volume < 0 || volume > 9) {
            throw new IllegalArgumentException("音量范围0-9");
        }
        // 调用逻辑同上，order改为 {"volume": volume}
    }
}

4.2 JavaScript/Node.js 集成

适用于Web前端或Node后端

const crypto = require('crypto');

// 配置信息
const CONFIG = {
    appId: 'your_app_id',
    appSecret: 'your_app_secret',
    deviceId: 'your_device_id',
    baseUrl: 'https://api.thingboot.com'
};

/**
 * 生成MD5签名
 */
function md5(str) {
    return crypto.createHash('md5').update(str).digest('hex');
}

/**
 * 生成请求签名
 */
function generateSign(ts) {
    const md5Secret = md5(CONFIG.appSecret);
    return md5(md5Secret + ts);
}

/**
 * 发送语音播报
 */
async function broadcast(text) {
    const ts = Math.floor(Date.now() / 1000);
    const sign = generateSign(ts);
    
    const url = `${CONFIG.baseUrl}/${CONFIG.appId}/device/control/?sign=${sign}&ts=${ts}`;
    
    const response = await fetch(url, {
        method: 'POST',
        headers: {
            'Content-Type': 'application/json'
        },
        body: JSON.stringify({
            device: CONFIG.deviceId,
            order: {
                'play:gbk:16': text
            }
        })
    });
    
    return response.ok;
}

// 调用示例:访客到达通知
await broadcast('[message_3] 前台来访客，请接待');

4.3 微信小程序集成

适用于写字楼物业小程序

五、写字楼场景应用案例

5.1 访客到达通知

业务流程：访客在前台登记后，系统自动呼叫被访员工

适用场景：替代人工电话通知，提升访客接待效率，减少前台工作量。

5.2 快递/外卖智能提醒

业务流程：扫码识别快递单号 → 查询收件人信息 → 定向播报通知

适用场景：与快递管理系统对接，实现无接触配送通知，避免漏取件。

5.3 会议室预定提醒

业务流程：会议预定系统 → 提前5分钟 → 语音提醒参会人员

适用场景：提升会议室使用效率，减少参会迟到现象。

5.4 紧急广播联动

业务流程：消防系统/安防系统告警 → 触发紧急广播

适用场景：与楼宇BA系统联动，火灾、地震等紧急情况自动播报。

六、进阶配置与优化

6.1 多设备分组管理

单个请求可同时对多个音柱下发命令，适合分层分区域控制：

6.2 私有化部署方案

对于对数据安全要求较高的写字楼，音柱支持纯局域网运行

自建消息服务器：准备Linux服务器，部署MQTT Broker
设备配置：在控制台配置私有服务器地址
接口封装：软件项目的HTTP请求直接指向本地服务器

优势：数据不外传、响应延迟更低（局域网80-120ms）、完全自主可控。

6.3 智能联动配置

芯步平台支持传感器与音柱联动。例如：

人体传感器检测到大厅无人 → 音柱自动调低音量
烟雾传感器告警 → 音柱触发疏散广播
温湿度传感器异常 → 音柱播报提醒

6.4 语音优化

优化项	措施	效果
多音字处理	使用同音字替代，如“银行”改为“银航”	避免误读
数字读法	金额用“一百二十三元”，手机号用“一八六”分段	提升辨识度
播报时长	单次播报控制在20字以内	避免信息过载
高峰策略	早晚高峰时段音量调至7-8，平时3-5	体验舒适

七、常见问题与解决方案

Q1：音柱播报有延迟怎么办？

排查步骤

检查网络环境：音柱信号强度需大于-65dBm
检查时间戳：确保ts值与服务器时间差不超过5分钟
私有化部署：考虑切换至局域网模式，延迟可降至80ms内

Q2：签名校验失败（401错误）？

常见原因

AppID或AppSecret填写错误
ts时间戳无效（服务器时间与客户端时间偏差过大）
签名计算顺序错误：正确为md5(md5(secret) + ts)

Q3：播报内容包含特殊字符怎么办？

使用GBK编码的play命令时，需对特殊字符进行URL编码或JSON转义。直接使用标准JSON字符串传递，平台会自动处理。

Q4：如何实现多音柱分区播报？

平台支持标签分组功能。在控制台为每层楼的音柱设置标签（如“F1大厅”“F2东区”），软件项目可指定标签进行群发，或逐个设备ID精确控制。

八、总结

芯步智能60W云控制语音音柱通过标准化HTTP开放接口，可快速集成至写字楼现有软件系统。本文提供的签名机制、接口规范和代码示例覆盖了Java、Node.js、微信小程序等主流技术栈，适用于OA系统、物业管理平台、小程序等多种软件形态。

核心优势总结

✅ 对接简单：仅需HTTP协议，无需硬件网关
✅ 部署灵活：支持公网/SaaS/私有化多种模式
✅ 场景丰富：访客接待、快递通知、会议提醒、紧急广播全覆盖
✅ 扩展性强：支持传感器联动、多设备分组、音量/音色远程调节

通过上述方案，写字楼可实现大厅语音播报的全面数字化升级，提升物业服务质量与管理效率。