如何用Java语言控制60W 远程控制 HTTP 接口音柱

2022-06-05 发布浏览：122 次

本文介绍了如何用 Java 对接智能语音音柱|60W 的方法：可以通过接口实现远程TTS语音播报、语音提醒发送、语音通知推送、语音警报播放、HTTP接口文本推送、内置铃声提示音播放、远程 TTS 语音播报、HTTP 接口文本推送、语音音量音色调节、定时语音通知触发、场景联动语音提示、设备状态语音反馈、远程音量调节控制、远程播放列表管理、设备运行状态监控、多设备语音同步播报、自定义语音模板设置、设备故障语音告警、自定义语音内容播报、语音播放进度控制、语音播放暂停控制、云平台语音推送、云端文本转语音播报、云端定时任务触发、云端设备状态监控。

智能语音音柱|60W

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

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

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

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

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

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

支持多音字、支持数字（数值、金额、手机号等）读法；

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

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

防尘防水，外形美观，安装简单；

更多...

适用场景

场馆语音播报、车间语音提醒、加油站语音通知、停车场语音播报、调度站语音提示、户外场景语音通知、门店订单语音播报、无人值守空间语音提示、线下服务语音提醒场景、快速分拣站语音播报、生产车间语音通知、工厂内语音播报、大型场馆语音广播、园区语音通知、快递分拣站、生产车间、校园公共区域语音通知、景区游客服务中心语音播报、社区公告语音提示、园区语音广播、物流园区语音通知、港口码头语音播报、地铁站语音提示、公交站点语音通知、商场语音播报、超市语音提示、仓库语音通知、智能办公工位语音提醒场景、前台接待语音引导场景、会议室预约签到语音提示场景、办公室茶水间语音通知场景、写字楼大厅语音播报场景、企业前台访客引导场景、会议室预约状态语音提示场景、办公区设备故障语音告警场景、智慧教室语音点名提醒场景、培训机构教室签到提示场景、图书馆自习室座位预约语音通知场景、实验室设备状态语音播报场景、教研教室教学辅助语音提示场景、创客工坊设备操作语音引导场景、学校活动室活动通知场景、培训教室上课下课语音提醒场景、酒店前台入住引导语音提示场景、餐厅奶茶店叫号语音播报场景、便利店收银台语音提示场景、共享空间前台语音引导场景、自助服务终端操作语音提示场景、银行网点叫号业务引导场景、医院导诊台语音指引场景、共享自习室前台语音引导场景、共享棋牌室服务台语音通知场景、共享台球室叫号预约提示场景、共享茶室前台语音接待场景、无人值守门店语音提示场景、自助设备操作引导语音提示场景、共享空间设备故障语音告警场景、无人值守场所安全语音提醒场景、工厂车间工位语音提醒场景、产线设备状态语音播报场景、仓库库存语音通知场景、设备机房维护提醒语音提示场景、生产线工位操作语音引导场景、设备巡检状态语音播报场景、生产车间安全规范语音提醒场景、产线异常情况语音告警场景、机场语音播报、医院语音提示、银行网点语音通知、展会现场语音播报、活动现场语音提示、公园语音广播、广场语音通知中

支持命令

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

产品手册

版本	对应产品手册
联网方式:无线WiFi\|播报内容:文本	《智能语音音柱60W产品手册》
联网方式:有线以太网+无线WiFi\|播报内容:文本	《智能语音音柱60W[有线网版]产品手册》
联网方式:无线WiFi\|播报内容:音频+文本	《智能语音音柱Pro60W产品手册》
联网方式:有线以太网+无线WiFi\|播报内容:音频+文本	《智能语音音柱Pro60W[有线网版]产品手册》

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的取值，请参考文档。