設(shè)備碰一碰配置指南

一、簡(jiǎn)介

碰一碰是HarmonyOS具備的多終端業(yè)務(wù)協(xié)同技術(shù)。其依托NFC短距通信協(xié)議，通過(guò)碰一碰的交互方式，將手機(jī)和全場(chǎng)景設(shè)備連接起來(lái)。然后通過(guò)手機(jī)端的原子化服務(wù)能力，快速完成配網(wǎng)、遠(yuǎn)程控制的能力，解決了應(yīng)用與設(shè)備之間接續(xù)慢、配網(wǎng)復(fù)雜、傳輸難的問(wèn)題，為用戶(hù)帶來(lái)無(wú)縫切換的流暢體驗(yàn)。

二、碰一碰配置

前提

• 已安裝數(shù)字管家應(yīng)用。
• 準(zhǔn)備已經(jīng)升級(jí)至HarmonyOS 2系統(tǒng)的華為Mate系列或P系列手機(jī)，系統(tǒng)版本號(hào)為2.0.0.168及以上。
• 在華為應(yīng)用市場(chǎng)，下載并安裝“應(yīng)用調(diào)測(cè)助手”APP，用于寫(xiě)NFC標(biāo)簽。
• 若開(kāi)發(fā)板不包含NFC模塊，則需準(zhǔn)備1個(gè)NFC標(biāo)簽，可以用手機(jī)觸碰NFC標(biāo)簽，提前確保NFC功能可用。
• 打開(kāi)手機(jī) 設(shè)置 > 應(yīng)用和服務(wù) > 應(yīng)用管理 ，搜索“智慧生活基礎(chǔ)服務(wù)”，檢測(cè)智慧生活基礎(chǔ)服務(wù)的版本是否為12.0.2.306及以上。如果不是，請(qǐng)打開(kāi)華為手機(jī)的“智慧生活”APP，點(diǎn)擊“ 我的 > 設(shè)置 > 檢查應(yīng)用更新 ”，更新“智慧生活基礎(chǔ)服務(wù)”。

智慧服務(wù)配置

申請(qǐng)Product ID

注：本節(jié)中Product ID是碰一碰拉起標(biāo)識(shí)，而非IoTDA平臺(tái)的設(shè)備產(chǎn)品ID。

登陸[華為開(kāi)發(fā)者聯(lián)盟]

登陸華為開(kāi)發(fā)者聯(lián)盟，主頁(yè)右上角管理中心按鈕，進(jìn)入管理中心。

創(chuàng)建智慧

在管理中心頁(yè)面中依次點(diǎn)擊智慧服務(wù)->HarmonyOS服務(wù)開(kāi)放平臺(tái)進(jìn)入智慧服務(wù)平臺(tái)。

點(diǎn)擊右上角創(chuàng)建服務(wù)按鈕。

選擇HarmonyOS測(cè)試服務(wù)，填寫(xiě)服務(wù)相關(guān)信息，點(diǎn)擊創(chuàng)建按鈕完成服務(wù)模型的創(chuàng)建。

錄入服務(wù)信息

在服務(wù)信息欄下的基本信息頁(yè)面完善服務(wù)模型基本信息后，點(diǎn)擊右上角保存按鈕，保存服務(wù)基本信息。

進(jìn)入服務(wù)呈現(xiàn)信息頁(yè)面完善相關(guān)信息（星標(biāo)項(xiàng)目必填，其它項(xiàng)目視需要進(jìn)行填寫(xiě)），可下載批量導(dǎo)入模板并填寫(xiě)，進(jìn)行批量導(dǎo)入。點(diǎn)擊右上角保存按鈕，保存服務(wù)呈現(xiàn)信息。

錄入服務(wù)配置信息

點(diǎn)擊配置欄，進(jìn)行配置信息的填寫(xiě)。 HarmonyOS標(biāo)簽頁(yè)面如下圖，其中產(chǎn)品型號(hào)填寫(xiě)在應(yīng)用調(diào)測(cè)助手中申請(qǐng)的Product ID ，產(chǎn)品子型號(hào)填寫(xiě)00。

FA信息頁(yè)面填寫(xiě)信息如下圖，其中App包名、服務(wù)名分別為FA開(kāi)發(fā)中對(duì)應(yīng)的IoT應(yīng)用的包名，以及開(kāi)發(fā)者期望通過(guò)NFC喚起的IoT應(yīng)用的服務(wù)名（本項(xiàng)目喚起的服務(wù)為設(shè)備配網(wǎng)）。

錄入服務(wù)測(cè)試信息

點(diǎn)擊測(cè)試欄，進(jìn)入智慧服務(wù)測(cè)試頁(yè)面，進(jìn)行測(cè)試相關(guān)信息的填寫(xiě)。 點(diǎn)擊創(chuàng)建進(jìn)入創(chuàng)建真機(jī)測(cè)試名單窗口。

填寫(xiě)手機(jī)號(hào)碼與描述。

點(diǎn)擊確定可以看到該手機(jī)已經(jīng)錄入名單中。

到此，應(yīng)用功能喚起信息申請(qǐng)和配置完成。

設(shè)備信息的準(zhǔn)備

鴻蒙開(kāi)發(fā)應(yīng)用知識(shí)參考[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]前往。

設(shè)備信息簡(jiǎn)介

設(shè)備信息內(nèi)容包括：華為IoTDA平臺(tái)的Product ID、NodeID、配網(wǎng)方式以及對(duì)應(yīng)的參數(shù)信息，如下列表格；所有信息需要寫(xiě)入到調(diào)測(cè)助手的自定義數(shù)據(jù)之中，然后通過(guò)NFC拉起應(yīng)用時(shí)，數(shù)字管家FA可通過(guò)Intent中的91字段進(jìn)行讀取NFC數(shù)據(jù)，從而可獲取到板子相關(guān)的信息。

存儲(chǔ)格式

設(shè)備信息采用TLV格式，即數(shù)據(jù)字段使用T+L+V進(jìn)行表示。

T:標(biāo)簽，1字節(jié)

L:T信息長(zhǎng)度，2字節(jié)

V:T對(duì)應(yīng)的詳細(xì)信息

標(biāo)簽分配

注：DeviceID由FA讀取NFC之后，使用華為IoTDA平臺(tái)設(shè)備產(chǎn)品ID+‘’_“+"NodeID"拼接而成，如華為IoTDA平臺(tái)設(shè)備產(chǎn)品ID為6128c7b60ad1ed0286680f19，NodeID為L(zhǎng)amp01,則生成的設(shè)備ID為”6128c7b60ad1ed0286680f19_Lamp01“

根據(jù)以上規(guī)則可編寫(xiě)TLV數(shù)據(jù)如下：

生成配網(wǎng)信息

1. 使用[NFC信息生成器]生成配網(wǎng)信息
2. 手動(dòng)輸入生成： 生成實(shí)際配網(wǎng)數(shù)據(jù)虛須基于[profile設(shè)備模型] 進(jìn)行編寫(xiě)，如以設(shè)備id為6128c7b60ad1ed0286680f19_Lamp01（華為IoTDA平臺(tái)設(shè)備產(chǎn)品ID+‘’_“+"NodeID"）的臺(tái)燈配網(wǎng)信息如下：

三、NFC數(shù)據(jù)寫(xiě)入

審核編輯 黃宇