設備管理

1 設備管理模型簡介

AbleCloud平台區分設備的管理員用戶與非管理員用戶。第一個綁定設備的用戶就是設備的管理員用戶。其他用戶要綁定設備需要得到管理員用戶的授權，比如通過管理員發放的分享碼來綁定設備。 普通用戶可以也僅可以主動解除自己與設備的綁定關係。管理員用戶可以解除任意用戶（包括自己）與設備的綁定關係。而且，如果管理員用戶解除了自己與設備的綁定關係，那麼同時也會解除設備與其他所有用戶的綁定關係。

1.1 設備綁定

直接綁定

// 實例化ACBindMgr對象

ACBindMgr bindMgr = ac.bindMgr(ac.newContext());

// 根據設備物理ID綁定設備

// 參數subDomain是設備所屬的子域的名字；

// 參數physicalId是設備的物理ID；

// 參數name是設備綁定后的顯示名稱；

// 參數userId是要綁定設備的用戶的ID。

ACUserDevice device = bindMgr.bindDevice(subDomain, physicalId, name, userId);

通過分享碼綁定

// 實例化ACBindMgr對象

ACBindMgr bindMgr = ac.bindMgr(ac.newContext());

// 通過分享碼綁定設備。參數shareCode即是設備分享碼。

ACUserDevice device = bindMgr.bindDeviceWithShareCode(shareCode, userId);

1.2 設備分享

設備分享是指以設備的管理員用戶的身份調用AbleCloud平台的介面生成設備的分享碼，其它用戶憑藉該分享碼綁定設備。

// 實例化ACBindMgr對象

ACBindMgr bindMgr = ac.bindMgr(ac.newContext());

// 獲取分享碼

// 參數deviceId是要被分享的設備的邏輯ID；

// 參數adminUserId是設備的管理員用戶的ID；

// 參數timeout是設備的分享碼的有效時長，單位是秒。

String shareCode = bindMgr.getShareCode(deviceId, adminUserId, timeout);

1.3 設備解綁

AbleCloud平台區分設備的管理員用戶及非管理員用戶。如果管理員用戶解除了與設備的綁定關係，那麼AbleCloud將自動解除其他用戶與設備的綁定關係。

// 實例化ACBindMgr

ACBindMgr bindMgr = ac.bindMgr(ac.newContext());

// 解綁設備

// subDomain是設備所屬子域的名字；

// deviceId是被解邦設備的邏輯ID；

// userId是要解邦設備的用戶的ID。

bindMgr.unbindDevice(subDomain, deviceId, userId);

原文鏈接：

http://docs.ablecloud.cn/current/java/site/guide_bridge_java/device/

北京智雲奇點科技有限公司（AbleCloud）是一家領先的物聯網雲服務平台，總部位於北京，在深圳、杭州設有分公司。AbleCloud面向企業，提供設備聯網與遠程管理、定製化雲端開發、海量硬體數據存儲與分析等基礎設施和服務，加速硬體實現聯網智能化。

公司官網：www.ablecloud.com

申請試用：https://www.ablecloud.cn/apply.php