怎样接入智能感应音响以实现远程播放列表管理_解决方案

CATALOG

芯步的智能感应音响通过标准HTTP接口开放了完整的播放控制能力——无需上传音频文件，直接推送文本即可实现TTS语音合成，同时也支持远程音量、音色、播放列表等管理。以下方案涵盖接口协议、签名算法、核心命令（播放/停止/列表切换）及多语言代码示例。

解决方案：基于芯步开放接口实现智能感应音响的远程播放列表管理

1. 概述

芯步的智能感应音响设备（如智能语音喇叭3、智能语音音柱等）支持通过 HTTP POST 请求 进行远程控制。该方案利用其开放接口，通过开发一个管理后台或移动端应用，实现对设备播放列表的远程管理，包括切换播放内容、调整音量、控制播放/停止等。

核心优势

无需录音上传：直接推送文本，设备端实时合成语音（TTS）。
实时响应：从请求发出到设备播报，延迟约为80-120ms。
多环境支持：支持公网、局域网及私有化部署。

2. 接口对接准备

在开始开发前，需要准备以下参数：

参数	说明	获取方式
AppID	应用唯一标识	在芯步控制台“开发设置”中获取
AppSecret	应用密钥（用于签名）	同上，请妥善保管
Device ID	目标设备ID	控制台设备列表查看
API Endpoint	`https://api.thingboot.com/{AppID}/device/control/`	固定格式

鉴权机制（签名计算）所有API请求需携带签名 sign 和时间戳 ts 以确保安全。签名算法如下

将 AppSecret 进行一次MD5加密：secret_md5 = md5(AppSecret)
拼接当前时间戳（秒级）：sign_str = secret_md5 + ts
将拼接后的字符串再次进行MD5加密：sign = md5(sign_str)

注意：时间戳 ts 需与计算签名时使用的保持一致。

3. 远程播放列表管理功能实现

“播放列表管理”在此场景下不完全等同于音乐播放器的列表，而是针对提示音、语音通知等场景的内容库管理与切换。可通过以下两类接口命令实现远程控制：

3.1 核心播放控制命令 (Order JSON)

通过修改请求体中的 order 参数，可实现以下管理功能

功能类别	命令字段	参数示例	功能描述
文本播报	`play:gbk:16`	`{"play:gbk:16":"欢迎光临XXX店"}`	核心功能，直接推送文本生成语音。可用于动态列表项。
内容切换	停止 + 播报	先发`{"stop":"1"}`，再发新内容	实现“上一首/下一首”逻辑：清空当前播报，立即播放新内容。
播放音效	`ring` / `message` / `alert`	`{"ring":"3"}`	播放内置铃声、提示音或警示音（各有5种可选）。
音量控制	`volume`	`{"volume":"7"}`	调节设备音量（0-9级）。
音色语调	`voice` / `speed` / `tone`	`{"voice":"1"}` (男声)	个性化语音输出。
停止播放	`stop`	`{"stop":"1"}`	全部停止，用于紧急打断或列表切换时。

3.2 “播放列表”的管理逻辑方案

由于API是无状态的，在你的业务服务器上维护一个播放列表（JSON数组）。

实现流程

列表存储：在数据库或内存中存储 Playlist，例如：["[message_1]商品促销信息：全场八折", "[ring_3]订单播报：您有新的外卖订单", "欢迎光临"]
远程下发
- 顺序播放：服务端依次读取列表内容，调用API发送 {"play:gbk:16":"内容"}。
- 指定切换：管理员在后台点击“下一首”，服务端调用 {"stop":"1"} 停止当前，接着下发列表中的下一条文本。
- 定时任务：结合时间调度（如cron），在特定时段（如开门/关门）自动下发特定语音内容。

4. 代码接入示例

以下示例展示了如何通过签名机制请求API，实现文本播报和音量调节。

4.1 Java 实现

使用 Java 和 Unirest 库实现

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

public class YoyoAudioController {
    public static void main(String[] args) {
        String AppID = "YOUR_APP_ID";
        String AppSecret = "YOUR_APP_SECRET";
        String deviceId = "YOUR_DEVICE_ID";
        long ts = System.currentTimeMillis() / 1000;
        
        // 签名计算
        String sign = DigestUtils.md5Hex(DigestUtils.md5Hex(AppSecret) + ts);
        String url = String.format("https://api.thingboot.com/%s/device/control/?sign=%s&ts=%d", AppID, sign, ts);
        
        // 命令:播报文本并调整音量为8
        String order = "{\"play:gbk:16\":\"你好，欢迎使用远程列表管理\", \"volume\":\"8\"}";
        String body = String.format("{\"device\":\"%s\",\"order\":%s}", deviceId, order);
        
        HttpResponse<String> response = Unirest.post(url)
                .header("Content-Type", "application/json")
                .body(body)
                .asString();
        
        System.out.println(response.getBody()); // 输出接口返回结果
    }
}

4.2 Shell (curl) 实现

无需复杂环境，直接通过命令行测试

4.3 Python 实现

5. 注意事项

网络环境：设备需连接2.4G WiFi，确保能访问公网API地址；若使用私有化部署，需将请求地址指向自建服务器。
中文字符编码play:gbk:16 中的 gbk 表示文本编码格式，请根据实际编程环境确保文本编码正确，避免乱码。
批量控制device 参数支持传入多个ID，用逗号分隔（如 "1878,1879"），可实现向一组音箱同步推送同一内容（如全店广播）。
数字读法：直接传数字金额或手机号，音响会自动以正确的朗读方式读取（如"100"读作"一百"）无需额外处理。

通过上述方案，开发者可以快速将芯步的智能音响集成到现有的ERP、POS或SaaS系统中，实现灵活、实时的远程音频播放列表管理。如需具体产品的完整命令列表，请参考对应产品手册。