怎样用Java语言对接智能通用控制器|16路

2025-12-07 发布浏览：816 次

本文介绍了如何用 Java 对接智能通用控制器|16路的方法：可以通过接口实现多达16路独立线路控制、控制16条线路通断、远程控制16路线路、控制16路交直流输出、16路设备集中控制、16路多通道独立控制、远程指令开关控制、定时任务启停控制、自定义场景联动控制、线路状态反馈控制、设备运行状态监控、远程参数配置管理、设备回路状态查询、多设备联动控制、过流保护自动断电、分组控制模式设置、远程批量开关控制、场景模式一键切换、设备故障告警通知。

智能通用控制器|16路

提供16路输出，可控制种交直流小负载；

外接交/直流接触器可控制大负载；

体积小、高集成度、方便安装、方便集成到其他设备内部；

广泛应用于售货柜、沙盘模型、集中控制1等场景；

16路分控，均可通过HTTP接口远程独立控制通断；

支持远程定时任务，支持自定义联动操作；

更多...

适用场景

智能化改造、自动售货柜控制、灯光控制、照明控制、便利店灯光控制、店铺招牌控制、展柜设备控制、仓储照明控制、楼宇公共照明、弱电间设备管理、民宿多设备联动、共享设备柜控制、自助储物柜控制、社区智能设施控制、机房设备控制、餐饮后厨设备控制、无人售货机控制、配电柜智能改造、工业自动化设备控制、产线设备控制、车间设备远程管理、共享自习室灯光设备控制、共享棋牌室设备电源控制、共享台球室灯光空调控制、共享茶室设备电源管理、自助洗车设备线路控制、快递柜设备控制、校园公共照明控制、停车场灯光设备控制、商场展柜电源控制、酒店客房设备集中控制、实验室多设备联动控制、教研实训设备远程管理、创客项目设备电源控制、写字楼公共区域照明控制、养老社区公共设备控制、仓储物流设备电源管理、景观灯光远程控制、户外亮化工程控制中

支持命令

线路1	power1
线路2	power2
线路3	power3
线路4	power4
线路5	power5
线路6	power6
线路7	power7
线路8	power8
线路9	power9
线路10	power10
线路11	power11
线路12	power12
线路13	power13
线路14	power14
线路15	power15
线路16	power16
批量控制	batch
先通后断	point
先断后通	reset

产品手册

版本	对应产品手册
灰色	《智能通用控制器16路产品手册》

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