怎么二次开发智能 5W 壁挂远程控制语音音箱以实现语音音量音色调节_解决方案

CATALOG

针对芯步智能5W壁挂音箱的音量音色调节二次开发，其实核心就是调用它的 HTTP 开放接口。芯步的设备接口非常统一，控制逻辑很简单：计算签名 -> 构造 JSON -> 发 POST 请求。

下面是具体的解决方案，偏口语化一些，直接告诉你该怎么做。

一、搞清楚原理，其实就是“发指令”

你不需要搞懂音箱里面复杂的电路。这音箱连着 WiFi，它会在后台默默等着服务器发指令。

我们要做的，就是让你的代码（不管是 Java、Python 还是 PHP）模拟成服务器，通过芯步的 HTTP 接口，给它发一条 JSON 格式的命令就行了。

关键点在于：任何能发 HTTP 请求的语言都能搞定，芯步提供了统一的 API 入口，不同设备只是 order 里的命令参数不一样而已。

二、准备工作

在写代码之前，先把“钥匙”拿到手：

注册账号：去芯步官网注册一个开发者账号。
找到密钥：登录后进入控制台，找到开发设置。你会拿到两个关键字符串：
- AppID：你的用户名。
- AppSecret：你的密码（这个要保密）。
拿到设备ID：把你这台“5W壁挂音箱”添加到控制台，设备列表里那一串数字就是 device 的唯一ID（比如 1878 这样的数字）。

三、核心难点：签名计算

这是官方为了安全加的“防盗门”。每次发指令必须带一个动态的 sign，防止别人随便控制你的设备。

计算规则其实很简单：最终签名 = MD5( MD5(AppSecret) + ts )

注意： 是 + 拼接字符串，不是数学运算。

举个例子，假设：

AppSecret = abc123
ts (当前时间戳) = 1712345678

步骤：

算 MD5(abc123) -> 得到 202cb962ac59075b964b07152d234b70
把上面结果拼上时间戳 -> 202cb962ac59075b964b07152d234b70 + 1712345678 = 202cb962ac59075b964b07152d234b701712345678
对这个新的字符串算 MD5 -> 8e7c628d9e0d7c7f4c8b7c7f4c8b7c7f (这就是你要的 sign)。

四、针对性解决方案：调节音量和音色

这是你最关心的部分。音箱的 order 参数是一个 JSON 对象。调节音量和音色有专用的指令，不需要去“播放”里面调。

调节音量：参数是 volume，取值范围 0 到 9（0是静音，9是最大）。
调节音色：参数是 voice，取值 0（女声）或 1（男声）。

示例：你想让音箱把音量调到 6，并且切换成男声。

你要发送的 order 参数就是：

特别注意： 官方示例里 volume 和 voice 传的是字符串 "6"，按照官方文档来。

五、动手写代码

这里用最通用的 Java 和 Python 举个例子，逻辑是一样的。

Java 示例

import com.google.gson.Gson;
import java.util.HashMap;
import java.util.Map;

public class YoyoiotControl {

public static void main(String[] args) {
        String AppID = "你的AppID";
        String AppSecret = "你的AppSecret";
        String deviceId = "你的设备ID(如1878)";
        
        // 1. 获取时间戳
        long ts = System.currentTimeMillis() / 1000;
        
        // 2. 计算签名 (需引入commons-codec或自己写MD5)
        String md5Secret = DigestUtils.md5Hex(AppSecret);
        String signRaw = md5Secret + ts;
        String sign = DigestUtils.md5Hex(signRaw);
        
        // 3. 构建请求URL
        String url = String.format("https://api.thingboot.com/%s/device/control/?sign=%s&ts=%d", 
                                    AppID, sign, ts);
        
        // 4. 构建命令 (重点:音量6，男声)
        Map<String, String> orderMap = new HashMap<>();
        orderMap.put("volume", "6");
        orderMap.put("voice", "1");
        
        // 5. 构建请求体
        Map<String, Object> bodyMap = new HashMap<>();
        bodyMap.put("device", deviceId);
        bodyMap.put("order", orderMap);
        
        String jsonBody = new Gson().toJson(bodyMap);
        
        // 6. 发送POST请求 (这里用OkHttp举例)
        OkHttpClient client = new OkHttpClient();
        Request request = new Request.Builder()
                .url(url)
                .post(RequestBody.create(jsonBody, MediaType.parse("application/json")))
                .build();
                
        client.newCall(request).enqueue(callback); // 发送
    }
}

Python 示例

六、进阶技巧和需要注意的点

别重复造轮子：如果只是调节音色，不用每次都发完整的 JSON。比如音箱正在响，你想让它变大声，单独发送 {"volume":"8"} 就行，它不会打断正在播报的内容。
完整控制：除了音量和音色，你还可以调节语速 (speed) 和语调 (tone)，范围都是 0-9。
加上提示音：很多场景下可以配合提示音使用。例如先播放“叮咚”声再说话：{"play:gbk:16":"[message_1]欢迎光临"}。
网络要求：音箱只支持 2.4G WiFi，配网的时候注意别连到 5G 信号上。
请求频率：官方限制单个设备 1 次/秒，别狂刷接口。

按照这个思路，你大概半小时内就能跑通第一个“音量调节”的 Demo。这本质上就是个发请求的活儿，核心就是把 order 字段写好。