簡介

本文檔為幫助開發(fā)者快速將設(shè)備接入到數(shù)字管家，完成FA、服務(wù)端和設(shè)備的通信，實(shí)現(xiàn)數(shù)字管家對(duì)設(shè)備的命令控制、日程管理，以及設(shè)備對(duì)數(shù)字管家的主動(dòng)告警。

快速上手

1. 前提參考：

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

• IoT平臺(tái)：完成IoT平臺(tái)新設(shè)備配置；
• 設(shè)備端：完成設(shè)備端的開發(fā)并定義好profile設(shè)備模型；
• 服務(wù)端：搭建并配置好了服務(wù)端；
• 數(shù)據(jù)庫：device_type表中添加好相關(guān)產(chǎn)品數(shù)據(jù)；

2. 編寫設(shè)備控制頁面

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

3. 頁面邏輯與數(shù)據(jù)處理

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

4. 接口對(duì)接

? 項(xiàng)目使用的網(wǎng)絡(luò)請求組件為RetrofitCache，項(xiàng)目中服務(wù)端api定義于ApiRx2，通過OKHttpUtilsRx2來實(shí)現(xiàn)異步調(diào)用。

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

如何驗(yàn)證

1. 寫入NFC數(shù)據(jù)

根據(jù)設(shè)備定義好的設(shè)備profile模型，使用應(yīng)用調(diào)測組助手將tlv格式數(shù)據(jù)寫入NFC NFC數(shù)據(jù)寫入章節(jié)。

2. 對(duì)設(shè)備進(jìn)行碰一碰配網(wǎng)

將手機(jī)靠近NFC標(biāo)簽，可正常拉起數(shù)字管家，并開始無感配網(wǎng)。

3. 驗(yàn)證設(shè)備跳轉(zhuǎn)入口

• 在線設(shè)備貼近設(shè)備NFC標(biāo)簽碰一碰，可正常跳轉(zhuǎn)至應(yīng)用；

• 在首頁設(shè)備Tab和新增日程頁面的設(shè)備圖標(biāo)能正確顯示設(shè)備狀態(tài)，在線設(shè)備點(diǎn)擊圖標(biāo)后可跳轉(zhuǎn)設(shè)備頁；

4. 驗(yàn)證功能

• 新增日程：在輸入成員、設(shè)備執(zhí)行動(dòng)作、執(zhí)行時(shí)間等后，日程頁面可看見新增的日程以及需執(zhí)行的動(dòng)作，在到達(dá)指定時(shí)間后所有設(shè)備能夠執(zhí)行預(yù)設(shè)動(dòng)作，并且相關(guān)成員手機(jī)會(huì)收到系統(tǒng)通知。

• 設(shè)備單點(diǎn)控制：進(jìn)入設(shè)備控制頁面，執(zhí)行控制操作設(shè)備能有相應(yīng)動(dòng)作執(zhí)行。
  
• 主動(dòng)告警：驗(yàn)證設(shè)備端能否通過AMQP通知到數(shù)字管家，例如智能垃圾桶檢測到垃圾桶已滿會(huì)通過服務(wù)端通知到相關(guān)用戶，并且能觸發(fā)鈴聲提醒和系統(tǒng)通知彈框。

審核編輯 黃宇