AI 助理
备案控制台
开发者社区 物联网 文章 正文

物联网平台实用技巧：调用API获取设备状态

2019-09-04 17337
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介： 物联网很多业务场景中，时常需要获取设备的实时状态，以便根据不同状态（在线或离线）做不同处理。阿里云物联网平台提供多个云端API来获取设备的状态信息。本文介绍这些API的调用方法。

产品推荐：阿里云物联网开发者工具（IoT Studio），立刻免费体验吧！  
 

原文链接
物联网很多业务场景中，时常需要获取设备的实时状态，以便根据不同状态（在线或离线）做不同处理。阿里云物联网平台提供多个云端API来获取设备的状态信息。本文介绍这些API的调用方法。

原理

以下五个API可以获得设备状态。请根据业务需要，选择调用的接口。
image.png

实现

本文示例使用Java SDK，需准备Java开发环境。
在Maven项目中，需添加如下pom依赖，安装阿里云IoT SDK。

<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>aliyun-java-sdk-core</artifactId>
  <version>3.5.1</version>
</dependency>
<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>aliyun-java-sdk-iot</artifactId>
  <version>6.11.0</version>
</dependency>
<dependency>
  <groupId>commons-codec</groupId>
  <artifactId>commons-codec</artifactId>
  <version>1.13</version>
</dependency>

Config.*参数值中，需传入您的阿里云账号AccessKey信息和设备信息。

  // 地域ID，根据您的物联网平台服务地域获取对应ID，https://help.aliyun.com/document_detail/40654.html
  private static String regionId = "cn-shanghai";
  // 您的阿里云账号AccessKey ID
  private static String accessKeyID = "Config.accessKey";
  // 您的阿里云账号AccesseKey Secret
  private static String accessKeySecret = "Config.accessKeySecret";
  // 要查询的设备所属产品的ProductKey
  private static String productKey = "Config.productKey";
  // 要查询的设备的名称DeviceName
  private static String deviceName = "Config.deviceName";

完整代码示例如下：

/*   
 * Copyright © 2019 Alibaba. All rights reserved.
 */
package com.aliyun.iot.demo.checkstatus;

import java.util.ArrayList;
import java.util.List;

import org.apache.commons.codec.binary.Base64;

import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.exceptions.ServerException;
import com.aliyuncs.iot.model.v20180120.BatchGetDeviceStateRequest;
import com.aliyuncs.iot.model.v20180120.BatchGetDeviceStateResponse;
import com.aliyuncs.iot.model.v20180120.BatchGetDeviceStateResponse.DeviceStatus;
import com.aliyuncs.iot.model.v20180120.BatchQueryDeviceDetailRequest;
import com.aliyuncs.iot.model.v20180120.BatchQueryDeviceDetailResponse;
import com.aliyuncs.iot.model.v20180120.BatchQueryDeviceDetailResponse.DataItem;
import com.aliyuncs.iot.model.v20180120.GetDeviceStatusRequest;
import com.aliyuncs.iot.model.v20180120.GetDeviceStatusResponse;
import com.aliyuncs.iot.model.v20180120.QueryDeviceDetailRequest;
import com.aliyuncs.iot.model.v20180120.QueryDeviceDetailResponse;
import com.aliyuncs.iot.model.v20180120.RRpcRequest;
import com.aliyuncs.iot.model.v20180120.RRpcResponse;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.profile.IClientProfile;

public class GetDeviceStatusByApi {

  // ===================需要用户填写的参数开始===========================
  // 修改Config.*的参数为您的实际信息
  // 地域ID，根据您的物联网平台服务地域获取对应ID，https://help.aliyun.com/document_detail/40654.html
  private static String regionId = "cn-shanghai";
  // 用户账号AccessKey ID
  private static String accessKeyID = "Config.accessKey";
  // 用户账号AccesseKey Secret
  private static String accessKeySecret = "Config.accessKeySecret";
  // 要查询的设备所属的产品ProductKey
  private static String productKey = "Config.productKey";
  // 要查询的设备名称deviceName
  private static String deviceName = "Config.deviceName";
  // ===================需要用户填写的参数结束===========================

  private static DefaultAcsClient client = null;

  private static DefaultAcsClient getClient(String accessKeyID, String accessKeySecret) {

    if (client != null) {
      return client;
    }

    try {
      IClientProfile profile = DefaultProfile.getProfile(regionId, accessKeyID, accessKeySecret);
      DefaultProfile.addEndpoint(regionId, regionId, "Iot", "iot." + regionId + ".aliyuncs.com");
      client = new DefaultAcsClient(profile);
    } catch (Exception e) {
      System.out.println("create Open API Client failed !! exception:" + e.getMessage());
    }

    return client;
  }

  /**
   * 设备状态获取
   * 方法一、二、三、四是基于状态查询的，获取的状态值可能会因为网络和心跳包延迟而延时更新；
   * 方法五是基于同步通信的，结果比较精准
   * 
   * @param args
   * @throws ServerException
   * @throws ClientException
   */
  public static void main(String[] args) throws ServerException, ClientException {

    // 获取服务端请求客户端
    DefaultAcsClient client = getClient(accessKeyID, accessKeySecret);

    GetDeviceStatusByApi api = new GetDeviceStatusByApi();

    // 方法一
    api.ByGetDeviceStatus(client);

    // 方法二
    api.ByBatchGetDeviceState(client);

    // 方法三
    api.ByQueryDeviceDetail(client);

    // 方法四
    api.ByBatchQueryDeviceDetail(client);

    // 方法五
    api.ByRRpc(client);
  }

  /**
   * 查询单设备运行状态
   * GetDeviceStatus https://help.aliyun.com/document_detail/69617.html
   * 
   * @param client 服务端请求客户端
   * @throws ServerException
   * @throws ClientException
   */
  public void ByGetDeviceStatus(DefaultAcsClient client) throws ServerException, ClientException {

    // 填充请求
    GetDeviceStatusRequest request = new GetDeviceStatusRequest();
    request.setProductKey(productKey); // 目标设备产品key
    request.setDeviceName(deviceName); // 目标设备名

    // 获取结果
    GetDeviceStatusResponse response = (GetDeviceStatusResponse) client.getAcsResponse(request);
    if (response != null && response.getSuccess()) {
      GetDeviceStatusResponse.Data data = response.getData();
      // ONLINE：设备在线。
      // OFFLINE：设备离线。
      // UNACTIVE：设备未激活。
      // DISABLE：设备已禁用。
      if ("ONLINE".equals(data.getStatus())) {
        System.out.println("GetDeviceStatus 检测：" + deviceName + " 设备在线");
      } else { // 其他状态归结为设备不在线，也可以根据业务情况自行区分处理
        System.out.println("GetDeviceStatus 检测：" + deviceName + " 设备不在线");
      }
    } else {
      System.out.println("GetDeviceStatus 检测：" + "接口调用不成功，可能设备 " + deviceName + " 不存在");
    }
  }

  /**
   * 批量查询设备运行状态
   * BatchGetDeviceState https://help.aliyun.com/document_detail/69906.html
   * 
   * @param client 服务端请求客户端
   * @throws ServerException
   * @throws ClientException
   */
  public void ByBatchGetDeviceState(DefaultAcsClient client) throws ServerException, ClientException {

    // 填充请求
    BatchGetDeviceStateRequest request = new BatchGetDeviceStateRequest();
    request.setProductKey(productKey); // 目标设备产品key
    List<String> deviceNames = new ArrayList<String>(); // 目标设备名列表
    deviceNames.add(deviceName);
    request.setDeviceNames(deviceNames);

    // 获取结果
    BatchGetDeviceStateResponse response = (BatchGetDeviceStateResponse) client.getAcsResponse(request);
    if (response != null && response.getSuccess()) {
      List<DeviceStatus> dsList = response.getDeviceStatusList();
      for (DeviceStatus ds : dsList) {
        // ONLINE：设备在线。
        // OFFLINE：设备离线。
        // UNACTIVE：设备未激活。
        // DISABLE：设备已禁用。
        if ("ONLINE".equals(ds.getStatus())) {
          System.out.println("BatchGetDeviceState 检测：" + ds.getDeviceName() + " 设备在线");
        } else { // 其他状态归结为设备不在线，也可以根据业务情况自行区分处理
          System.out.println("BatchGetDeviceState 检测：" + ds.getDeviceName() + " 设备不在线");
        }
      }
    } else {
      System.out.println("BatchGetDeviceState 检测：" + "接口调用不成功，可能设备 " + deviceName + " 不存在");
    }
  }

  /**
   * 查询单设备详细信息
   * QueryDeviceDetail https://help.aliyun.com/document_detail/69594.html
   * 
   * @param client 服务端请求客户端
   * @throws ServerException
   * @throws ClientException
   */
  public void ByQueryDeviceDetail(DefaultAcsClient client) throws ServerException, ClientException {

    // 填充请求
    QueryDeviceDetailRequest request = new QueryDeviceDetailRequest();
    request.setProductKey(productKey); // 目标设备产品key
    request.setDeviceName(deviceName); // 目标设备名

    // 获取结果
    QueryDeviceDetailResponse response = (QueryDeviceDetailResponse) client.getAcsResponse(request);
    if (response != null && response.getSuccess()) {
      QueryDeviceDetailResponse.Data data = response.getData();
      // ONLINE：设备在线。
      // OFFLINE：设备离线。
      // UNACTIVE：设备未激活。
      // DISABLE：设备已禁用。
      if ("ONLINE".equals(data.getStatus())) {
        System.out.println("QueryDeviceDetail 检测：" + deviceName + " 设备在线");
      } else { // 其他状态归结为设备不在线，也可以根据业务情况自行区分处理
        System.out.println("QueryDeviceDetail 检测：" + deviceName + " 设备不在线");
      }
    } else {
      System.out.println("QueryDeviceDetail 检测：" + "接口调用不成功，可能设备 " + deviceName + " 不存在");
    }
  }

  /**
   * 批量查询设备详细信息
   * BatchQueryDeviceDetai https://help.aliyun.com/document_detail/123470.html
   * 
   * @param client 服务端请求客户端
   * @throws ServerException
   * @throws ClientException
   */
  public void ByBatchQueryDeviceDetail(DefaultAcsClient client) throws ServerException, ClientException {

    // 填充请求
    BatchQueryDeviceDetailRequest request = new BatchQueryDeviceDetailRequest();
    request.setProductKey(productKey); // 目标设备产品key
    List<String> deviceNames = new ArrayList<String>(); // 目标设备名列表
    deviceNames.add(deviceName);
    request.setDeviceNames(deviceNames);

    // 获取结果
    BatchQueryDeviceDetailResponse response = (BatchQueryDeviceDetailResponse) client.getAcsResponse(request);
    if (response != null && response.getSuccess()) {
      List<DataItem> diList = response.getData();
      for (DataItem di : diList) {
        // ONLINE：设备在线。
        // OFFLINE：设备离线。
        // UNACTIVE：设备未激活。
        // DISABLE：设备已禁用。
        if ("ONLINE".equals(di.getStatus())) {
          System.out.println("BatchQueryDeviceDetail 检测：" + di.getDeviceName() + " 设备在线");
        } else { // 其他状态归结为设备不在线，也可以根据业务情况自行区分处理
          System.out.println("BatchQueryDeviceDetail 检测：" + di.getDeviceName() + " 设备不在线");
        }
      }
    } else {
      System.out.println("BatchQueryDeviceDetail 检测：" + "接口调用不成功，可能设备 " + deviceName + " 不存在");
    }
  }

  /**
   * RRPC 检测设备状态
   * RRpc https://help.aliyun.com/document_detail/69797.html
   * 
   * @param client 服务端请求客户端
   * @throws ServerException
   * @throws ClientException
   */
  public void ByRRpc(DefaultAcsClient client) throws ServerException, ClientException {

    // 填充请求
    RRpcRequest request = new RRpcRequest();
    request.setProductKey(productKey);// 目标设备产品key
    request.setDeviceName(deviceName);// 目标设备名
    request.setRequestBase64Byte(Base64.encodeBase64String("Hello World".getBytes())); // 消息内容，必须base64编码字符串
    request.setTimeout(5000); // 响应超时设置，可根据实际需要填写数值

    // 获取结果
    RRpcResponse response = (RRpcResponse) client.getAcsResponse(request);
    if (response != null) { // 不要使用response.getSuccess()判断，非SUCCESS都是false；直接使用RrpcCode判断即可
      // UNKNOWN：系统异常
      // SUCCESS：成功
      // TIMEOUT：设备响应超时
      // OFFLINE：设备离线
      // HALFCONN：设备离线（设备连接断开，但是断开时间未超过一个心跳周期）
      if ("SUCCESS".equals(response.getRrpcCode())) {
        System.out.println("RRPC 检测：" + deviceName + " 设备在线");
      } else if (response.getRrpcCode() == null) {
        System.out.println("RRPC 检测：" + deviceName + " 设备可能不存在");
      } else { // 其他状态归结为设备不在线，也可以根据业务情况自行区分处理
        System.out.println("RRPC 检测：" + deviceName + " 设备不在线:");
      }
      // RRPC 还可以实现更复杂的设备状态检测方法
      // 请参考 https://help.aliyun.com/document_detail/101133.html
    } else {
      System.out.println("RRPC 检测：" + "接口调用不成功");
    }
  }
}
文章标签：
物联网平台
物联网
API
Java
关键词：
物联网平台设备
API设备
物联网平台API
API物联网平台
API调用
相关实践学习
钉钉群中如何接收IoT温控器数据告警通知
本实验主要介绍如何将温控器设备以MQTT协议接入IoT物联网平台，通过云产品流转到函数计算FC，调用钉钉群机器人API，实时推送温湿度消息到钉钉群。
阿里云AIoT物联网开发实战
本课程将由物联网专家带你熟悉阿里云AIoT物联网领域全套云产品，7天轻松搭建基于Arduino的端到端物联网场景应用。 开始学习前，请先开通下方两个云产品，让学习更流畅： IoT物联网平台：https://iot.console.aliyun.com/ LinkWAN物联网络管理平台：https://linkwan.console.aliyun.com/service-open
智能计算灵骏
目录
相关文章
游客g5tp3lgf24cqc
|
3天前
|
Web App开发 网络协议 安全
基于Web攻击的方式发现并攻击物联网设备介绍
基于Web攻击的方式发现并攻击物联网设备介绍
游客g5tp3lgf24cqc
19 4
土木林森
|
14天前
|
安全 物联网 物联网安全
智能物联网安全：物联网设备的防护策略与最佳实践
【10月更文挑战第26天】随着物联网（IoT）技术的快速发展，智能设备已广泛应用于智能家居、工业控制和智慧城市等领域。然而，设备数量的激增也带来了严重的安全问题，如黑客攻击、数据泄露和恶意控制，对个人隐私、企业运营和国家安全构成威胁。因此，加强物联网设备的安全防护至关重要。
土木林森
37 7
一名技术开发者
|
15天前
|
监控 安全 物联网
确保互联世界中物联网设备安全的三个技巧
确保互联世界中物联网设备安全的三个技巧
一名技术开发者
24 1
一个物联网卡发烧友
|
1月前
|
物联网 5G 智能硬件
物联网卡：物联网卡不支持语音通话，是如何实现设备间的数据传输和通信的？
物联网卡（IoT SIM卡）通常被设计用于支持物联网（IoT）设备之间的数据传输，而不直接支持语音通话功能。这是因为物联网设备主要关注的是数据的收集、传输和处理，而不是语音通信。为了实现设备间的数据传输和通信，物联网卡及其背后的技术采用了多种方法，主要包括但不限于以下几种方式：
一个物联网卡发烧友
58 1
物联网卡：物联网卡不支持语音通话，是如何实现设备间的数据传输和通信的？
一个物联网卡发烧友
|
24天前
|
物联网
物联网卡不能使用在什么设备上
“物联网卡不能使用在什么设备上”这一操作或规定，通常基于物联网卡的特性、使用条款以及设备兼容性等因素。以下是对这一问题的详细分析和操作建议：
一个物联网卡发烧友
36 6
华汇数据
|
27天前
|
存储 监控 物联网
医疗物联网设备精细化管理系统解决方案
华汇数据智慧医院物联网管理系统解决方案是一种集物联网、云计算、大数据和人工智能等先进技术于一体的综合性解决方案，旨在提升医院的运营效率、医疗质量和患者满意度。
华汇数据
65 3
一个物联网卡发烧友
|
1月前
|
安全 物联网
物联网卡不能更换设备使用吗
物联网卡（IoT SIM卡）是否允许更换设备使用，这主要取决于物联网服务提供商的具体政策和服务条款。通常，物联网卡是为特定设备或应用场景设计的，因此一些服务提供商会限制卡的更换使用，主要是出于安全、管理、网络优化和避免滥用等考虑
一个物联网卡发烧友
37 2
土木林森
|
13天前
|
安全 物联网 物联网安全
智能物联网安全：物联网设备的防护策略与最佳实践
【10月更文挑战第27天】随着物联网技术的快速发展，智能设备已广泛应用于生活和工业领域。然而，物联网设备的安全问题日益凸显，主要威胁包括中间人攻击、DDoS攻击和恶意软件植入。本文探讨了物联网设备的安全防护策略和最佳实践，包括设备认证和加密、定期更新、网络隔离以及安全标准的制定与实施，旨在确保设备安全和数据保护。
土木林森
31 0
一位隐者
|
1月前
|
人工智能 安全 物联网
5G如何增强物联网（IoT）设备的安全性？
【10月更文挑战第8天】
一位隐者
64 0
一位隐者
|
1月前
|
存储 安全 物联网
5G与物联网设备：安全保障，构建万物互联新生态
【10月更文挑战第1天】
一位隐者
51 0

物联网

热门文章

最新文章

  • 1
    阿里云的物联网之路
  • 2
    PostgreSQL "物联网"应用 - 1 实时流式数据处理案例(万亿每天)
  • 3
    AliOS Things 3.0应用笔记：http client简单应用
  • 4
    Link Vision 打破传统视频监控模式，开启新型物联网智能视频服务
  • 5
    3个小故事，带你追溯物联网的起源
  • 6
    NodeMCU快速上云集锦
  • 7
    关于IoT网络的一些特征的探讨
  • 8
    基于开源MQTT自主接入阿里云IoT平台（C#）
  • 9
    基于开源MQTT自主接入阿里云IoT平台（Node.js）
  • 10
    农业的未来：物联网，农业传感器，农业无人机
  • 1
    java小工具util系列5：java文件相关操作工具，包括读取服务器路径下文件，删除文件及子文件，删除文件夹等方法
    11
  • 2
    List集合按照由小到大排序或者由大到小排序
    3
  • 3
    院内导航怎么实现？解析信息化医院的智慧导航技术
    9
  • 4
    如何选择合适的 CRC 多项式
    7
  • 5
    第六届计算机工程与应用国际学术会议 (ICCEA 2025) 2025 6th International Conference on Computer Engineering and Application
    12
  • 6
    第五届工业制造与新材料国际学术会议（IMNM 2025） 2025 5th International Conference on Industrial Manufacturing and New Materials（IMNM 2025）
    8
  • 7
    智能停车解决方案之停车场室内导航系统（二）：核心技术与系统架构构建
    15
  • 8
    一些常用的 Salesforce IoT Cloud 中间件工具
    14
  • 9
    Java“NumberFormatException”解决
    5
  • 10
    java Runtime.exec()执行shell/cmd命令：常见的几种陷阱与一种完善实现
    11

    • 相关产品

  • 物联网平台
    文档详情 产品详情

    • 相关课程

    更多
  • 大咖带你聊物联网
  • 基于STM32的端到端物联网全栈开发
  • 走进阿里云物联网
  • 阿里云物联网平台专题介绍
  • 物联网平台开发全栈教程
  • 物联网平台云上开发

    • 相关电子书

    更多
  • Spring Boot2.0实战Redis分布式缓存
  • CUDA MATH API
  • API PLAYBOOK

    • 相关实验场景

    更多
  • 基于Assistant Api的旅游助手
  • 快速体验智能体API应用
  • 温控器设备接入IoT物联网平台与数据管理实践
  • 使用物联网平台远程管理运维设备
  • 阿里云IoT小程序应用开发和组件实践
  • 搭建IoT小程序开发环境，创建一个应用
    • 下一篇
    阿里云OSS设置跨域访问