怎样用Java语言控制智能Mini语音喇叭

2026-07-02 发布浏览：937 次

本文介绍了如何用 Java 对接智能语音喇叭Mini 的方法：可以通过接口实现远程指令语音播报控制、自定义语音内容播报、定时语音通知触发、场景联动语音提示、设备状态语音反馈、远程音量调节控制、远程播放列表管理、设备运行状态监控、多设备语音同步播报、自定义语音模板设置。

智能语音喇叭Mini

远程语音播报、语音提醒、语音通知；

广泛应用于各种线下服务的订单提醒、线下流程的语音提醒等；

体积小巧，方便插入、携带；

无需上传录音、无需后台设置；

直接通过HTTP接口推送文本，即可实时远程语音播报；

真人发声、语调自然柔和，支持男、女音色；

支持远程音量、音色、语调、语速设置；

内置铃声、提示音、警示音各5种；

可无缝接入各种OA、ERP、SaaS软件和低代码平台中；

更多...

适用场景

共享自习室小型语音通知场景、共享棋牌室小型语音播报场景、共享台球室小型语音提示场景、共享茶室小型语音广播场景、无人售货机小型语音提示场景、自助洗车设备小型语音播报场景、设备机房小型语音告警场景、产线设备小型语音通知场景、酒店客房小型语音提示场景、写字楼办公区小型语音广播场景、智慧教室小型语音播报场景、养老社区小型语音通知场景中

支持命令

音量	volume
音色	voice
语速	speed
语调	tone
播报	play:gbk:16
铃声	ring
提示音	message
警示音	alert
停止	stop

产品手册

版本	对应产品手册
白色	《智能语音喇叭Mini产品手册》

HTTP接口控制以设备控制（向设备下发命令）为例

// First you need to prepare the following values
// 1. AppID (in your console development settings)
// 2. AppSecret (in your console development settings)
// 3. ts (timestamp of the current time, seconds)
// 4. YourSign = md5(md5(AppSecret)ts);(md5 is an encryption method, AppSecret is the AppSecret prepared above, ts is the timestamp prepared above, concatenate the string after the AppSecret after md5 encryption)
// In simple terms, the signature is md5(md5(your developer password)concatenate the above ts timestamp value); ts is the timestamp of the current timestamp; that is, to perform one MD5 on the developer password (AppSecret), then concatenate the timestamp, and then perform one MD5 on the entire concatenated string
// Core request address: api.thingboot.com/AppID/device/control/?sign=YourSign&&ts=ts;
// Request needs to pass two parameters device and order:
// device[string]: unique device ID, can pass multiple [separated by ,], can be viewed in the console, or pulled through the interface
// order[json string]: the command to be issued, for example:
// {"power":1}, usually to connect the circuit of the switch
// {"power3":0}, usually to close the third line of the switch or controller
// {"play:gbk:16":"hello, welcome to visit"}, let the voice speaker report the specified content
// The same type of product, the command is the same, different product types of commands, please view the product manual page of each product
// Note: you must replace the formal AppID and AppSecret with real-time timestamp calculation of the signature, the request must have device device ID and order command

/*首先，确保在你的项目中添加了 unirest 的 Maven 依赖。如果你使用的是 Maven，可以在 pom.xml 中添加以下依赖：
<dependency>
    <groupId>com.konghq</groupId>
    <artifactId>unirest-java</artifactId>
    <version>3.13.10</version>
</dependency>
*/

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

public class Main {
    public static void main(String[] args) {
        // 定义变量
        String AppID = "开发者ID"; // 替换为实际的 AppID
        String AppSecret = "开发者密码"; // 替换为实际的 AppSecret
        long ts = System.currentTimeMillis() / 1000; // 获取当前时间戳（秒）

        // 计算签名 md5(md5(开发者密码)拼接上面的ts参数)
        String sign = DigestUtils.md5Hex(DigestUtils.md5Hex(AppSecret) + ts);

        // 构建 URL
        String url = String.format("https://api.thingboot.com/%s/device/control/?sign=%s&ts=%d", AppID, sign, ts);

        // 请求体数据
        String device = "1878"; // 替换为实际的设备ID；可传多个[用,间隔]
        String order = "{\"power1\":1}"; // 替换为实际的命令

        try {
            // 构建请求体
            String postData = String.format("{\"device\":\"%s\",\"order\":%s}", device, order);

            // 发送 POST 请求
            HttpResponse<String> response = Unirest.post(url)
                    .header("Content-Type", "application/json")
                    .body(postData)
                    .asString();

            // 输出响应
            System.out.println(response.getBody());
        } catch (UnirestException e) {
            e.printStackTrace();
        }
    }
}

// First you need to prepare the following values
// 1. AppID (in your console development settings)
// 2. AppSecret (in your console development settings)
// 3. ts (timestamp of the current time, seconds)
// 4. YourSign = md5(md5(AppSecret)ts);(md5 is an encryption method, AppSecret is the AppSecret prepared above, ts is the timestamp prepared above, concatenate the string after the AppSecret after md5 encryption)
// In simple terms, the signature is md5(md5(your developer password)concatenate the above ts timestamp value); ts is the timestamp of the current timestamp; that is, to perform one MD5 on the developer password (AppSecret), then concatenate the timestamp, and then perform one MD5 on the entire concatenated string
// Core request address: api.thingboot.com/AppID/device/control/?sign=YourSign&&ts=ts;
// Request needs to pass two parameters device and order:
// device[string]: unique device ID, can pass multiple [separated by ,], can be viewed in the console, or pulled through the interface
// order[json string]: the command to be issued, for example:
// {"power":1}, usually to connect the circuit of the switch
// {"power3":0}, usually to close the third line of the switch or controller
// {"play:gbk:16":"hello, welcome to visit"}, let the voice speaker report the specified content
// The same type of product, the command is the same, different product types of commands, please view the product manual page of each product
// Note: you must replace the formal AppID and AppSecret with real-time timestamp calculation of the signature, the request must have device device ID and order command

/*
首先，确保在你的项目中添加了 OkHttp 的 Maven 依赖。如果你使用的是 Maven，可以在 pom.xml 中添加以下依赖：
<dependency>
    <groupId>com.squareup.okhttp3</groupId>
    <artifactId>okhttp</artifactId>
    <version>4.9.3</version>
</dependency>
*/

import okhttp3.*;
import org.apache.commons.codec.digest.DigestUtils;

import java.io.IOException;

public class Main {
    public static void main(String[] args) {
        // 定义变量
        String AppID = "开发者ID"; // 替换为实际的 AppID
        String AppSecret = "开发者密码"; // 替换为实际的 AppSecret
        long ts = System.currentTimeMillis() / 1000; // 获取当前时间戳（秒）

        // 计算签名 md5(md5(开发者密码)拼接上面的ts参数)
        String sign = DigestUtils.md5Hex(DigestUtils.md5Hex(AppSecret) + ts);

        // 构建 URL
        String url = String.format("https://api.thingboot.com/%s/device/control/?sign=%s&ts=%d", AppID, sign, ts);

        // 请求体数据
        String device = "1878"; // 替换为实际的设备ID；可传多个[用,间隔]
        String order = "{\"power1\":1}"; // 替换为实际的命令

        // 构建请求体
        String postData = String.format("{\"device\":\"%s\",\"order\":%s}", device, order);

        // 创建 OkHttpClient 实例
        OkHttpClient client = new OkHttpClient();

        // 创建请求体
        MediaType mediaType = MediaType.parse("application/json; charset=utf-8");
        RequestBody body = RequestBody.create(postData, mediaType);

        // 创建请求
        Request request = new Request.Builder()
                .url(url)
                .post(body)
                .addHeader("Content-Type", "application/json")
                .build();

        // 发送请求并处理响应
        try (Response response = client.newCall(request).execute()) {
            if (!response.isSuccessful()) throw new IOException("Unexpected code " + response);

            // 输出响应
            System.out.println(response.body().string());
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

说明：{AppID}为您的应用ID（由平台生成），免费注册登录后，可在控制台查看；sign和ts的取值，请参考文档。