鑒權(quán)（Auth）?

Application訂閱平臺(tái)數(shù)據(jù)

?

注冊(cè)直連設(shè)備的通知

Profile簡(jiǎn)介

開發(fā)者使用華為IoT平臺(tái)集成設(shè)備時(shí)需要準(zhǔn)備此設(shè)備的能力描述文件，既設(shè)備的Profile文件。

    設(shè)備的Profile文件是用來描述一款設(shè)備“是什么”、“能做什么”以及“如何控制該設(shè)備”的文件。該文件會(huì)被上傳到華為IoT平臺(tái)。

    Profile命名規(guī)范l 對(duì)設(shè)備類型、服務(wù)類型、服務(wù)標(biāo)識(shí)采用首字母大寫的命名法，

         如：MultiSensor、Switch；

    參數(shù)使用首字母小寫，其余單詞的首字母大寫的駝峰式命名法，

         如：paraName、dataType；

    命令使用所有字母大寫，單詞之間用下劃線連接的格式，

         如：DISCOVERY，CHANGE_COLOR；

    設(shè)備能力描述json文件，

         固定命名devicetype-capability.json;

    服務(wù)能力描述json文件，

    固定命名servicetype-capability.json;

Profile命名規(guī)范注意點(diǎn)    

    廠商標(biāo)識(shí)、型號(hào)唯一標(biāo)示一個(gè)設(shè)備類型，故這兩者不能與其他類型設(shè)備同時(shí)重復(fù)。僅支持英文。 

    設(shè)備類型和廠商標(biāo)識(shí)之間不要使用下劃線，平臺(tái)是根據(jù)下劃線從左到右依次區(qū)分設(shè)備類型、廠商標(biāo)識(shí)和設(shè)備型號(hào)的。 Profile設(shè)計(jì)規(guī)范l 要注重名稱的通用性，簡(jiǎn)潔性；對(duì)于服務(wù)能力描述，還要考慮其功能性。

    如：對(duì)于多傳感器設(shè)備，就可以命名為Multi(多)Sensor(傳感器)；對(duì)于某設(shè)備具有顯示電量的服務(wù)，就可以命名為Battery。

 Profile文件打包結(jié)構(gòu)Profile寫作完成后，需要按如下表格形式打包。

下面以附錄四中WaterMeter_Huawei_NBIoTDevice.zip為例介紹。

關(guān)于上圖有幾點(diǎn)說明：

① Profile文件的目錄層級(jí)結(jié)構(gòu)必須如圖所示，不能增刪；

比如第二層級(jí)必須只有“profile”和“service”兩個(gè)文件夾，每個(gè)服務(wù)下面必須包含“profile”等。

② 圖中橙色的命名不能改動(dòng)；

③ 整個(gè)Profile以zip形式壓縮；

④ Profile文件的命名必須按照deviceType_manufacturerId_model的格式命名，其中的deviceType、manufacturerId、model必須與devicetype-capability.json中的對(duì)應(yīng)字段的定義一致，例如，本例中的devicetype-capability.json的主要字段如下：

{

   "devices": [

       {

           "manufacturerId": "Huawei",

           "manufacturerName": "Huawei",

           "model": "NBIoTDevice",

           "protocolType": "CoAP",

           "deviceType": "WaterMeter",

           "serviceTypeCapabilities": ****

       }

   ]

}

⑤ 圖中的Brightness、Electricity、Temperature都是devicetype-capability.json中定義的服務(wù)。

⑥ Profile文件中的文檔格式都是json，在編輯完成后可以在互聯(lián)網(wǎng)上查找一些格式校驗(yàn)網(wǎng)站，檢查json的合法性。?