怎么二次开发15W 远程 TTS 语音壁挂音箱来实现云端定时任务触发_解决方案

CATALOG

芯步这款15W壁挂音箱本质上是“接收HTTP指令的终端”，实现云端定时播报的核心思路就是：用一台云服务器当“大脑”，在规定时间往音箱的API接口“扔”一句话。下面是一套完整的二次开发方案，按步骤来就能搭建起来。

一、整体思路：怎么让音箱“听话”？

要实现云端定时触发，不需要对音箱硬件本身做任何改装。你只需要做三件事：

看懂它的语言：音箱对外暴露了一个HTTP接口，你给它发一个 POST 请求，它就能说话。
找个“钟表匠”：在你的云服务器上写一个定时脚本（比如Node.js或Python脚本）。
制定“日程表”：使用 cron（Linux定时任务）或Windows计划任务，设定在几点几分执行这个脚本。

简单说，就是：定时任务 -> 触发脚本 -> 调用API -> 音箱播报。

二、准备工作：拿到“钥匙”和“地址”

在动手写代码之前，先去芯步的官方控制台拿到以下三样东西：

AppID 和 AppSecret （开发者密码）：这是你的身份标识，调用接口时用来生成签名。
设备ID （Device ID） ：贴在音箱背面或者控制台列表里能看到的那串数字，相当于音箱的手机号。
网络配置：确保你的15W音箱已经连上了WiFi（只支持2.4G），只要能和云端通信就行。

三、核心接口分析：它是怎么“说话”的？

这个15W音箱用的是标准的HTTP接口，具体的请求格式如下，你需要仔细看这个结构：

请求地址（URL） ：https://api.thingboot.com/{你的AppID}/device/control/?sign={计算出来的签名}&ts={当前时间戳}
请求方法： POST
请求体（Body） ：
{ "device": "这里是你的设备ID", "order": {"play:gbk:16": "这里放你要播报的文字"} }

这里有个关键点：签名计算接口为了安全需要验证签名，规则是：sign = md5( md5(AppSecret) + ts )。简单说，就是把你的 AppSecret 做一次MD5加密，然后拼接上当前的时间戳，再把拼接后的字符串做一次MD5加密。

四、实战环节：写一个“让音箱说话”的脚本

这里选用了Node.js作为示例。你可以把下面的代码保存为 speak.js。

// 引入必要的库
const crypto = require(‘crypto’); // 用于计算签名
const http = require(‘http’);     // 用于发送请求

// 1. 填写你的配置信息（这里换成你自己的）
const config = {
    appId: ‘你的AppID’,
    appSecret: ‘你的AppSecret’,
    deviceId: ‘你的设备ID’,
    // 这里就是你想要它说的话
    text: ‘大家好，现在是下午三点了，该开会了。’
};

// 2. 计算签名 （这是最关键的一步，别漏了）
const ts = Math.floor(Date.now() / 1000); // 获取当前秒级时间戳
const md5Secret = crypto.createHash(‘md5’).update(config.appSecret).digest(‘hex’);
const sign = crypto.createHash(‘md5’).update(md5Secret + ts).digest(‘hex’);

// 3. 拼接请求地址
const url = `http://api.thingboot.com/${config.appId}/device/control/?sign=${sign}&ts=${ts}`;

// 4. 组装你要发的"指令包" 
// 注意:如果想让声音好听点，可以设置语速（speed）和音色（voice）
const postData = JSON.stringify({
    device: config.deviceId,
    order: {
        "play:gbk:16": config.text,   // 播报文本
        "speed": 5,                   // 语速 0-9，5是正常
        "voice": "女声",              // 或者 "男声"
        "volume": 7                  // 音量 0-9
    }
});

// 5. 发送请求
const req = http.request(url, {
    method: ‘POST’,
    headers: { ‘Content-Type’: ‘application/json’ }
}, (res) => {
    console.log(‘状态码:’， res.statusCode);
    console.log(‘播报指令已发送’);
});

req.write(postData);
req.end();

运行测试：在服务器上跑一下 node speak.js，如果音箱响了，说明你的“钥匙”和签名算法都是对的。

五、实现“定时触发”：加上一个“闹钟”

脚本写好了，现在我们要让它定时跑起来。在Linux服务器上最方便的就是用 Crontab。

在终端输入 crontab -e 编辑定时任务，加上这一行：

如果是在Windows上，可以用“任务计划程序”创建一个基本任务，触发器设为“每天”，操作设为“启动程序”，程序填 node，参数填你脚本的路径。

六、进阶玩法：让它更聪明一点

既然你已经在做二次开发了，光播报一句话肯定不够。你可以利用它的API参数，玩点更花的：

“打招呼”模式：在播报前动态拼接内容。
- 场景：有人刷卡进门。
- 代码“欢迎” + userName + “，现在是” + getCurrentTime（）。
调节音量和音色：根据时间段调整参数。
- 场景：晚上10点后的提醒，自动把音量降到2，避免太吵。
播放提示音：在说话前来个“叮咚”。
- 指令：在 order 里加上 “ring”： 1（它会先响一声内置铃声再说话）。

七、避坑指南（血泪经验）

在实际操作中，你可能会遇到几个小问题：

签名错误：这是最常见的问题。请请一定要确认 md5 出来的结果是32位小写的格式。
Text编码：命令里的 play：gbk：16 表示中文编码。如果播出来是乱码，检查一下你的脚本文件是不是保存为了 UTF-8 格式（基本都是）。这个 gbk 是设备内部的识别符，一般不用改。
网络延迟：虽然是毫秒级响应，但在公网环境下偶尔会有1-2秒的延迟。如果需要瞬间响应用户操作（比如按按钮），配合本地局域网使用[1]。
不要频繁重复播报：你的定时任务逻辑要写好，避免因为循环bug一秒钟发几百次请求，虽然音箱扛得住，但可能会把你的接口配额刷爆。

这套方案的核心优势在于“零侵入”，你不需要懂硬件电路，也不用刷固件，全是纯软件层面的对接，维护起来很方便。