文档首页/ IoT物联网/ SDK参考/ 设备侧Agent Lite API参考(Java)（联通用户专用）/ 非直连设备管理/ 更新设备状态
更新时间：2024-07-01 GMT+08:00
查看PDF
分享

更新设备状态

接口功能

通过该接口更新设备的状态信息，包括直连设备与所管理的非直连设备。设备离线、上线均可通过该接口刷新设备状态信息。

直连设备状态通过设备的登录状态进行管理，当直连设备连接断开则表示设备离线，当直连设备连接或重连成功，则表示设备上线，无需通过该接口进行刷新。故建议开发者使用该接口刷新非直连设备的状态。

接口描述

1
 
public static boolean updateDeviceStatus(int cookie, String deviceId, String status, String statusDetail);

接口所属类

HubService

参数说明

字段

必选/可选

类型

描述

cookie

可选

int

Cookie有效值为1-65535。

deviceId

必选

String

设备Id。

status

必选

String

设备状态。

  • 在线: ONLINE。
  • 离线: OFFLINE。

statusDetail

必选

String

设备状态详细信息。

  • 无：NONE。
  • 配置等待：CONFIGURATION_PENDING。
  • 通信错误：COMMUNICATION_ERROR。
  • 配置错误：CONFIGURATION_ERROR。
  • 桥接器离线：BRIDGE_OFFLINE。
  • 固件升级：FIRMWARE_UPDATING。
  • 循环任务：DUTY_CYCLE。
  • 未激活：NOT_ACTIVE。

接口返回值

返回值

描述

true

成功。

false

失败。

此返回值是调用接口的同步返回结果，返回true只是说明接口调用成功，并不说明设备状态更新成功，设备状态更新成功需要收到HubService发出的通知。

示例

开发者调用设备状态更新接口。

1
 
HubService.deviceStatusUpdate(0, deviceId, “ONLINE”, “NONE”);

开发者调用设备状态更新接口需前要实现Agent Lite提供的观察者接口。

1
2
3
4
5
 
public class Subscribe implements MyObserver {
    public Subscribe (Observable hubService) {
        hubService. registerObserver (this);
    }
    @Override同设备添加
父主题： 非直连设备管理

相关文档