HarmonyOS開發：【數字管家app設備接入FA】

簡介

本文檔為幫助開發者快速將設備接入到數字管家，完成FA、服務端和設備的通信，實現數字管家對設備的命令控制、日程管理，以及設備對數字管家的主動告警。

快速上手

1. 前提參考：

鴻蒙開發文檔：[docs.qq.com/doc/DUmN4VVhBd3NxdExK]

• IoT平臺：完成IoT平臺新設備配置；
• 設備端：完成設備端的開發并定義好profile設備模型；
• 服務端：搭建并配置好了服務端；
• 數據庫：device_type表中添加好相關產品數據；

2. 編寫設備控制頁面

1. 在slice目錄下新建 xxxxSlice.java文件，通過 addActionRoute() 方法為此AbilitySlice配置一條路由規則，并且在在應用配置文件（config.json）中注冊，
2. 在resources->base->layout下新建對應xml布局文件，在上述兩個文件中編寫相應界面代碼。

3. 頁面邏輯與數據處理

1. slice頁面獲取deviceId：在onStart中通過調用intent.getStringParam("deviceId") ，獲取設備標識用于對設備進行控制或者獲取設備信息。
   
2. slice頁面獲取狀態：對于可以主動控制的設備，調用intent.getBooleanParam(KEY_IS_SET_COMMAND, false) ，用于判斷當前狀態下是需要執行命令，還是通過 [EventBus]將命令數據傳出用于日程對設備的編排之中。
3. 編寫設備控制命令的獲取和解析方法：在CommandUtil中根據具體設備profile定義，來新增獲取命令和解析命令的方法，以供設備調用sendCommand來發送命令和在日程中來解析命令。
4. 配置設備相關信息：在DeviceData類的initData方法中，根據設備productId添加設備圖片資源ID、跳轉的action參數和日程解析方法，配置完成后設備列表頁、日程頁面等都能通過該配置進行圖片加載、路由跳轉和日程解析。
5. 以上代碼邏輯處理和實現可參考LampAbilitySlice.java。

4. 接口對接

? 項目使用的網絡請求組件為RetrofitCache，項目中服務端api定義于ApiRx2，通過OKHttpUtilsRx2來實現異步調用。

1. 若使用自己部署的服務端，須做如下修改: (1) 將OKHttpUtilsRx2類中SERVER_URL變量修改為自己的服務端api地址; (2) 將DeviceStateListener類中RABBITMQ_HOST變量修改為自己的服務端地址;
2. 初始化設備狀態：通過調用getDeviceInfo接口，傳入deviceId和userId來獲取，其中UserId在登錄時會儲存于Preferences輕量級數據存儲之中。
3. 設備控制命令：通過調用sendCommand接口，傳入deviceId和命令json字符串來對指定設備進行控制。
   

如何驗證

1. 寫入NFC數據

根據設備定義好的設備profile模型，使用應用調測組助手將tlv格式數據寫入NFC NFC數據寫入章節。

2. 對設備進行碰一碰配網

將手機靠近NFC標簽，可正常拉起數字管家，并開始無感配網。

3. 驗證設備跳轉入口

• 在線設備貼近設備NFC標簽碰一碰，可正常跳轉至應用；

• 在首頁設備Tab和新增日程頁面的設備圖標能正確顯示設備狀態，在線設備點擊圖標后可跳轉設備頁；

4. 驗證功能

• 新增日程：在輸入成員、設備執行動作、執行時間等后，日程頁面可看見新增的日程以及需執行的動作，在到達指定時間后所有設備能夠執行預設動作，并且相關成員手機會收到系統通知。

• 設備單點控制：進入設備控制頁面，執行控制操作設備能有相應動作執行。
  
• 主動告警：驗證設備端能否通過AMQP通知到數字管家，例如智能垃圾桶檢測到垃圾桶已滿會通過服務端通知到相關用戶，并且能觸發鈴聲提醒和系統通知彈框。

審核編輯 黃宇