如何对接60W 智慧园区语音终端音柱以实现远程播放列表管理_解决方案

CATALOG

芯步60W智慧园区音柱的开放接口基于HTTP协议，核心是通过签名认证向设备下发order指令来实现远程播报管理。以下方案围绕“播放列表”这一业务抽象，说明如何将单次播报指令扩展为可编排的播放任务。

1. 背景与概述

在智慧园区场景中，60W智能语音音柱通常部署于停车场、花园步道、垃圾站、消防通道等户外区域，承担背景音乐播放、寻人启事、安全警示、定时广播等任务。然而，传统单次调用HTTP接口下发文本的模式缺乏对播放内容的持续性管理与编排能力。本文将基于芯步智能语音音柱Pro 60W的开放API，设计一套远程播放列表管理方案，实现对多台音柱播放内容的集中编排、定时调度与状态追踪。

该方案采用了设备侧无需固件修改的纯API集成方式，利用设备内置的TTS芯片与HTTP Server能力，通过业务后端实现播放任务的逻辑控制。

2. 核心对接技术原理

2.1 接口基础

60W智慧音柱支持WiFi 2.4G或有网线以太网入网，在局域网或公网环境下，开放标准的HTTP接口。任何后端服务（Java, Python, Go, PHP等）均可通过构造HTTP请求对其进行控制。

2.2 设备控制请求结构

所有控制指令均通过以下Endpoint发送：

URL： http(s)://api.thingboot.com/{AppId}/device/control/
Method： POST
鉴权方式： URL参数携带签名（Sign）和时间戳（ts）
Content-Type： application/json

签名生成规则（防篡改与鉴权）

为了防止接口被恶意调用，需要对每一次请求进行签名。算法逻辑如下

拼接字符串： str = md5(AppSecret) + ts
计算签名： sign = md5(str)
注：AppSecret 在物联网控制台获取，ts 为精确到秒的Unix时间戳。

2.3 60W音柱关键指令集

针对“播放列表管理”，我们需要用到以下核心参数（通过 order 字段传递）

功能分类	指令示例（order JSON）	说明
文字播报	`{"play:gbk:16":"欢迎光临智慧园区"}`	核心TTS能力，将文字转语音。支持`[p0]`（短停顿）等SSML标记
音量调节	`{"volume":"7"}`	范围 0-9，园区户外 7-8
音色语速	`{"voice":"1"}` （1-男声/0-女声）`{"speed":"5"}`	调节播报风格
提示音前置	`{"play:gbk:16":"[message_3]垃圾车即将进站"}`	播报前自动播放提示音，起到警示作用
停止播放	`{"stop":"1"}`	紧急情况下的静音指令

3. 远程播放列表管理设计

要实现“播放列表管理”，不能仅依赖单次播报，需要在您的云服务器或本地服务器中构建一个播控中心。

3.1 逻辑架构图

管理端：运营人员在Web后台配置播放列表（时段、内容、音量、循环模式）。
业务后端：存储播放列表，利用定时任务（Scheduler）或消息队列驱动API调用。
设备层： 60W音柱接收指令并执行。

3.2 状态维护机制

由于HTTP是无状态的，且设备IP可能在4G/WiFi环境中变动，本方案采用 “主动推送+设备自协商” 模式：

后端无需维护长连接。
列表下发策略：针对一个列表（如包含5条播报），后端按照编排的时间间隔，依次调用API推送单条内容。

4. 核心功能实现细节

4.1 播放列表的数据模型设计

在您的业务数据库中，可以设计如下结构来映射播放任务：

4.2 代码实现示例

以下以 Java (Spring Boot) 为例，演示如何封装一个服务，通过播放列表向60W音柱下发指令。

// 1. 签名生成工具类
public class YoYoSignUtil {
    public static String genSign(String appSecret, long timestamp) {
        String md5Secret = DigestUtils.md5Hex(appSecret);
        String rawString = md5Secret + timestamp;
        return DigestUtils.md5Hex(rawString);
    }
}

// 2. 播放服务实现
@Service
public class VoiceBroadcastService {
    @Value("${yoyo.app-id}")
    private String appId;
    @Value("${yoyo.app-secret}")
    private String appSecret;
    private RestTemplate restTemplate = new RestTemplate();

public void executePlaylistTask(String deviceId, String text, int volume, int speed) {
        // 构建请求参数
        long ts = System.currentTimeMillis() / 1000;
        String sign = YoYoSignUtil.genSign(appSecret, ts);
        
        String url = String.format("https://api.thingboot.com/%s/device/control/?sign=%s&ts=%d", appId, sign, ts);
        
        // 构建Order指令
        Map<String, Object> order = new HashMap<>();
        // 支持多音字和数字读法优化
        String smartText = text.replace("重庆", "[chong2qing4]"); 
        order.put("play:gbk:16", smartText);
        order.put("volume", String.valueOf(volume));
        order.put("speed", String.valueOf(speed));
        
        Map<String, Object> requestBody = new HashMap<>();
        requestBody.put("device", deviceId);
        requestBody.put("order", order);
        
        // 发送请求（设置超时时间）
        HttpEntity<Map<String, Object>> entity = new HttpEntity<>(requestBody, httpHeaders);
        ResponseEntity<String> response = restTemplate.postForEntity(url, entity, String.class);
        
        if (response.getStatusCode().is2xxSuccessful()) {
            log.info("音柱 {} 播报成功: {}", deviceId, text);
        }
    }
}

4.3 定时调度与列表循环

利用 Quartz 或 Spring @Scheduled 实现定时扫描：

扫描：每隔1分钟扫描数据库，找出当前时间点需要触发的播放列表。
拆解：读取列表中的 Tasks 数组。
执行：按顺序并发调用 executePlaylistTask。

注意：60W音柱播报单条文本通常需要耗时几百毫秒到几秒，如果列表连续多条内容，后端需要做延迟队列处理，使用 Thread.sleep(delay_ms) 或延迟队列来保证播报不被覆盖（Pro版支持打断，可根据业务选择是否强占）。

5. 部署与网络

5.1 组网方案

芯步60W音柱支持有线以太网与WiFi 2.4G。

智慧园区推荐： 有线方案。园区环境复杂，2.4G WiFi干扰较大（蓝牙、ZigBee等），有线接入能保证播放列表下发的高成功率与低延迟。

5.2 私有化部署 (局域网)

针对安全性要求比较高的园区（如政府、军工、研发中心），芯步产品支持私有化部署。

方案：将API服务部署在园区内网服务器，音柱通过网线连接核心交换机。
优势：播放列表数据不出园区，不受公网抖动影响，响应更快。

6. 常见问题与优化

6.1 多音字与数字读法优化

在园区播报中，经常出现“重庆路”、“¥99.9”等场景。

解决方案：在下发文本前，利用正则表达式处理。
- 多音字： 重庆 -> [chong2qing4]
- 金额： 99.9元 -> [money]99.9[/money]
- 手机号： 138xxxx -> [telephone]138xxxx[/telephone]

6.2 “播放列表”中断恢复

如果在播放列表执行中途，人为通过麦克风喊话或紧急按钮打断了播放。

恢复策略：后端可以通过维护每个设备的“当前播放进度”状态。若检测到设备空闲（或者主动发心跳查询，视具体固件支持），重新下发未完成的列表项。最简单的做法是忽略中断，等待下一个整点或半点调度。

7. 总结

通过对接芯步60W智慧音柱的开放接口（尤其是其灵活的 play:gbk:16 TTS指令），开发人员可以在不修改固件的前提下，通过构建业务后端轻松实现 “远程播放列表管理” 。该方案充分利用了HTTP接口的简洁性与设备的TTS语音合成能力，适用于园区定时广播、自动巡检播报、应急疏散指示等多种智慧园区场景。