更新设备状态
接口功能
通过该接口更新设备的状态信息,包括直连设备与所管理的非直连设备。设备离线、上线均可通过该接口刷新设备状态信息。
直连设备状态通过设备的登录状态进行管理,当直连设备连接断开则表示设备离线,当直连设备连接或重连成功,则表示设备上线,无需通过该接口进行刷新。故建议开发者使用该接口刷新非直连设备的状态。
接口描述
1
|
public static boolean updateDeviceStatus(int cookie, String deviceId, String status, String statusDetail); |
接口所属类
HubService
参数说明
字段 |
必选/可选 |
类型 |
描述 |
---|---|---|---|
cookie |
可选 |
int |
Cookie有效值为1-65535。 |
deviceId |
必选 |
String |
设备Id。 |
status |
必选 |
String |
设备状态。
|
statusDetail |
必选 |
String |
设备状态详细信息。
|
接口返回值
返回值 |
描述 |
---|---|
true |
成功。 |
false |
失败。 |
返回结果
广播名称 |
广播参数 |
成员 |
描述 |
---|---|---|---|
TOPIC_DEVSTATUS_UPDATA_RSP |
IotaMessage对象 (使用intent.getSerializableExtra(HubService.HUB_BROADCAST_IE_IOTAMSG)方法获取) |
HUB_IE_RESULT |
设备状态更新结果。 |
HUB_IE_DEVICEID |
设备ID。 |
HUB_IE_RESULT:
枚举项 |
枚举值 |
类型 |
描述 |
---|---|---|---|
HUB_RESULT_SUCCESS |
0 |
NA |
添加/删除执行成功。 |
HUB_RESULT_DEVICE_EXIST |
1 |
NA |
设备已存在。 |
HUB_RESULT_DEVICE_NOTEXIST |
2 |
NA |
设备不存在。 |
HUB_RESULT_DEVICE_FAILED |
255 |
NA |
执行失败。 |
示例
1
|
HubService.deviceStatusUpdate(0, deviceId, “ONLINE”, “NONE”); |
然后等待命令执行结果:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
// 开发者注册广播接收器对设备状态更新结果进行相应的处理 BroadcastReceiver mReceiverDevStatus; mReceiverDevStatus = new BroadcastReceiver() { @Override public void onReceive(Context context, Intent intent) { //获取IotaMessage IotaMessage iotaMsg = (IotaMessage)intent.getSerializableExtra(HubService.HUB_BROADCAST_IE_IOTAMSG); //获取响应的错误码 String result = iotaMsg.getString(HubService.HUB_IE_RESULT); String deviceId = iotaMsg.getString(HubService.HUB_IE_DEVICEID); ... return true; } } mLocalBroadcastManager = LocalBroadcastManager.getInstance(this); IntentFilter filterDiscon= new IntentFilter(HubService. TOPIC_DEVSTATUS_UPDATA_RSP); mLocalBroadcastManager.registerReceiver(mReceiverDevStatus, filterDiscon); |