電信物聯(lián)網(wǎng)開(kāi)放平臺(tái)北向應(yīng)用quickstart

安裝 配置Java環(huán)境變量（Windows操作系統(tǒng) 安裝 7直連設(shè) 上傳Profile資源包樣 使用Postman測(cè)試平臺(tái)北向接 Profile文件的寫作問(wèn) 1restful接口功能，體驗(yàn)業(yè)務(wù)功能，熟悉業(yè)LiteDemo，比對(duì)發(fā)給平獲取中國(guó)電信物聯(lián)網(wǎng)開(kāi)放對(duì)接信IPAppId和您可以發(fā)送郵件 javaJDKEclipse的方法。如果java，請(qǐng)自行準(zhǔn)備開(kāi)發(fā)環(huán)境。Java環(huán)境變量（Windows操作系統(tǒng)請(qǐng)務(wù)必安裝JDK1.8版本。JDK1.8官網(wǎng)地址 Java環(huán)境變量（Windows操作系統(tǒng)PATH存在，另外兩個(gè)變量需要新lib，binFiles\Java\jdk1.8.0_45\bin能識(shí)別。CLASSPATH的取值為“.;%JA_HOME%\lib\dt.jar;%JA_HOME%\lib\tools.jar’.，windows最后可以通過(guò)DOS命令來(lái)檢查環(huán)境變量是否配置成功。打開(kāi)Windows令行，運(yùn)行如下令來(lái)檢查你的Java安裝，命令行如下：C:\Users\username>echoC:\Users\username>javacusernameEclipse版本和jdk必須都是32位的，或者都是64位的，否則找不到j(luò)vm.dll官網(wǎng)地址打開(kāi)Eclipse，選擇菜單File->New->Project，在彈出的框中選擇JavaProject，點(diǎn)擊Next（JavaProject為例，可以根據(jù)實(shí)際情況選擇其他工程，如果您已有自己JRE1.8Finish將到的樣例代碼解壓，進(jìn)入LiteNADemo_https\src，拷貝如下圖所示的兩個(gè)文件（Ctrl+C快捷鍵Ctrl+V將文件夾粘貼到工程srcLibrariesAddJARs，進(jìn)入工程\Opensourcecomponentsjar，最后點(diǎn)OK。導(dǎo)入jar包之后工程中的錯(cuò)誤就會(huì)全部5在調(diào)用接口前要先修改平臺(tái)IP端口、appId和等常量的值。打開(kāi)Constants.java，常量的值：如果樣例代碼的注解中出現(xiàn)“pleaserece”的字樣，開(kāi)發(fā)者需要根據(jù)實(shí)際情況修改常量或變量Authentication.javaRunAsJava8.2章節(jié)的內(nèi)容進(jìn)行單步調(diào)測(cè)。accessToken會(huì)在expiresIn所標(biāo)志的時(shí)間內(nèi)過(guò)期，expiresInrefreshToken來(lái)獲取新的accessToken。RefreshTokenAPI文檔和樣例代碼中的LiteDemo平臺(tái)將設(shè)備消息分類推送給北向應(yīng)用（API文檔中“Application訂閱平臺(tái)Constants.java，修改CALLBACK_BASE_URLIP和端口（回調(diào)地址中Authentication.javaRunAsJavaApplication，就可以在控制臺(tái)看到響應(yīng)消如需修改訂閱的回調(diào)地址，在Constants.java類中修改各回調(diào)地址的值，再次訂閱即可。新的訂閱完成后，開(kāi)發(fā)者可參考SubscribeNotifyResource.java搭建一個(gè)應(yīng)用服務(wù)器來(lái)接收平臺(tái)推送的Post消息。SubscribeNotifyResource.java參考。如果需要在本地測(cè)試平臺(tái)回調(diào)功能RegisterDirectlyConnectedDevice.javaverifyCode/nodeIdtimeoutverifyCode/nodeId需要與真實(shí)設(shè)備的唯一標(biāo)識(shí)符（IMEIMAC）一致。如果使用verifyCode可以是數(shù)字、字母和特殊符號(hào)的組合，開(kāi)發(fā)者可verifyCode重復(fù)（本文使用模擬器設(shè)備。timeout時(shí)間單位是秒，timeouttimeout=0，的設(shè)備不會(huì)過(guò)期timeout>0，真實(shí)設(shè)備必須在設(shè)置的時(shí)間內(nèi)上線，否則的設(shè)備會(huì)過(guò)期而被timeout180timeoutRegisterDirectlyConnectedDevice.javaRunAsJavaApplication，就由于LiteDemo中沒(méi)有建立數(shù)據(jù)庫(kù)，需要手動(dòng)拷貝并保存deviceId，以備調(diào)用其他設(shè)備相關(guān)的接口時(shí)使用。在設(shè)備未上線之前，再次調(diào)用設(shè)備接口則可刷新deviceId。設(shè)備只是新增一個(gè)設(shè)備第一個(gè)步驟。設(shè)備需要與真實(shí)設(shè)備對(duì)接起來(lái)才能使用，否則設(shè)備成功后可以使用查詢單個(gè)設(shè)備信息或按條件批量查詢?cè)O(shè)備信息的接口查詢?cè)O(shè)備信QueryDeviceData.java、QueryDevices.javaAPI文檔。Profile登錄SPportal后，在設(shè)備管理->模型->導(dǎo)入模型頁(yè)面上傳到的Profile資源包樣Profile資源包直接導(dǎo)入平臺(tái)。開(kāi)發(fā)者可自行設(shè)計(jì)上報(bào)數(shù)據(jù)和下發(fā)命令的字段，在設(shè)ProfileModifyDeviceInfo.javadeviceId、deviceType、manufacturerId、manufacturerName、protocolType、model。其中deviceId是設(shè)備時(shí)得到的。NB-IoT設(shè)備，protocolType必須為CoAP，另外三個(gè)字段可自行定義，ProfileWaterMeter、sew、n001。ModifyDeviceInfo.javaRunAsJavaApplication，就可以在控制臺(tái)此接口使用到的deviceId是設(shè)備時(shí)得到的。如果之前的設(shè)備過(guò)期了，需要重新設(shè)備，獲得新的deviceId，否則修改設(shè)備信息時(shí)會(huì)出錯(cuò)。平臺(tái)根據(jù)manufacturerId和model來(lái)找到設(shè)備對(duì)應(yīng)的Profile文件和編插件，所以設(shè)備信設(shè)備被賦予了Profile中所配置的設(shè)備能力。QueryDeviceData.java、QueryDevices.java及API文檔。綁定設(shè)備，即設(shè)備首次上線的動(dòng)作。設(shè)備上報(bào)的數(shù)據(jù)中攜帶設(shè)備標(biāo)識(shí)符（IMEI或Mac地址等），經(jīng)編插件成功并與的verifyCode/nodeId匹配起來(lái)，則綁定成功，設(shè)備狀態(tài)就變成online。Portal提供的模擬設(shè)備。在創(chuàng)建設(shè)備模擬器頁(yè)面下方填入設(shè)備名稱與（必須與設(shè)備時(shí)使用verifyCode保持一致SetState，將設(shè)置設(shè)備狀態(tài)的按鈕置為打開(kāi)狀態(tài)，則設(shè)備就QueryDeviceData.java、QueryDevices.javaAPI文使用LiteDemo下設(shè)備命令打 mandV4.java，將修改deviceId為設(shè)備時(shí)得到的deviceId mandV4.java，選擇RunAs->JavaApplication，就可以在控制臺(tái)看到Step10。執(zhí)行結(jié)果推送到該回調(diào)地址。詳見(jiàn)該接口的callbackUrl字段。為了方便開(kāi)發(fā)者了解平臺(tái)是否已推送消息給應(yīng)用，LiteDemo中提供了一個(gè)簡(jiǎn)單的HTTPNotifyType.javaTEST_CALLBACK_BASE_URL常量中的IP和端口。Demo使用的簡(jiǎn)單的HTTP服務(wù)器只本地端口，TEST_CALLBACK_BASE_URL中不能TestSubscribeAllNotification.javaRunAsJavaApplication，就可以在控制臺(tái)看到啟動(dòng)了端口和訂閱的回調(diào)地址。aterMetereclipse控制臺(tái)就能看到平臺(tái)推送給應(yīng)用的消息（設(shè)備數(shù)據(jù)上報(bào)后，平臺(tái)會(huì)將緩存令下發(fā)給設(shè)備?？梢栽陂_(kāi)發(fā)者Portal設(shè)備模擬器的控制臺(tái)看到平臺(tái)下發(fā)令。13

PostmanChromeWebAPI&HTTP請(qǐng)求調(diào)試，可APIAPPserverLiteDemo相似的功能，IDE。PostmanPostmanIoT平臺(tái)北向接口。如PostmanHTTP協(xié)議測(cè)試接口可以跳過(guò)本步驟。由于版本的Postman不支持https接口測(cè)試，此方法只適用于http協(xié)議的接口測(cè)務(wù)器的公網(wǎng)IP，中國(guó)電信工程師會(huì)將您的公網(wǎng)IP配置到IoT平臺(tái)的HTTP白中，HTTPIP與端口發(fā)送給您。ChromeChromePostman。PostmanChromePostman：

http方法、URLhttp方法、URLURLhttpshttp，并且手動(dòng)server:portiphttp端口。注意：URLAPISend按鈕，就能在下方看到返回碼及消息內(nèi)容。將返回的內(nèi)容（http方法、URL將返回的內(nèi)容（尤其是deviceId）并保存起來(lái)，以備后續(xù)調(diào)用其他接口時(shí)使用http方法、URL點(diǎn)擊“SendPostmanhttp/https消息的代碼處打上斷點(diǎn)，以便調(diào)試，如在樣例代碼HttpsUtil.javaexecuteHttpRequest3個(gè)斷點(diǎn)（請(qǐng)根據(jù)您代碼的實(shí)際情況打：（Authentication.java->Variables窗口看到相應(yīng)的變量的內(nèi)容，包括發(fā)出去的消息及平臺(tái)的響URLentity中可以看到發(fā)出去的消息內(nèi)容。appIdsecretcontentASCII碼表示，所以不能一眼就看ASCII碼表將其一一轉(zhuǎn)化為字母和符號(hào)。Response按鈕使程序向下運(yùn)行，直到斷點(diǎn)再第二次命中executeHttpRequest中發(fā)送http/https消息的地方，StepOver按鈕運(yùn)行到如下圖所示的位置再查看變量?jī)?nèi)容。VariablesrequestResponseProfileProfileProfile文件的編寫是較容易出現(xiàn)問(wèn)題的地方，本節(jié)通過(guò)介紹常見(jiàn)的問(wèn)題，從而增加開(kāi)Profile文件的認(rèn)識(shí)，進(jìn)而避免問(wèn)題的發(fā)生。ProfileProfile文件模版直接修改。Profile文件的格式多，字根據(jù)與伙伴 server對(duì)接調(diào)測(cè)過(guò)程，總結(jié)問(wèn)題如下ProfileProfile寫作的遇到的第一個(gè)問(wèn)題就是如何定義一個(gè)服務(wù)。當(dāng)前服務(wù)的定義沒(méi)有明確的Profile文件是一款設(shè)備的如果物理屬性APP server不關(guān)心，也可以不定義。彩燈是智能彩燈，APPserver可以通過(guò)命令控制彩燈，將智能功能歸納為一種服務(wù)也ProfileProfile編寫者的理解。devicetype-capability.jsonservicetype-capability.jsonjson的格式。通過(guò)網(wǎng)上搜索引擎查詢json格式校驗(yàn)，建議完成Profile文件后可以通過(guò)這些進(jìn)行校驗(yàn)。通過(guò)校驗(yàn)可以排除掉一些比較基本錯(cuò)誤，如攜帶中文字符、缺少標(biāo)點(diǎn)符號(hào)、額外添加內(nèi)容等。14-1Profile名需以deviceType_manufacturerId_model的方式命名ziprar壓縮包的層 被可目前網(wǎng)上的打包工具打包后 結(jié)構(gòu)如圖14-2所示，顯然多了一 Profile文件中對(duì)每個(gè)字段的描述都是度的，因此也有自己的格式。paraName、dataType、maxLength維度就無(wú)意義了，這時(shí)請(qǐng)根據(jù)《中國(guó)電信物聯(lián)網(wǎng)開(kāi)放平臺(tái)_IoTprofile開(kāi)發(fā)指南》對(duì)其進(jìn)行賦值。每一個(gè)命令中的字段都Profile文件模版的基礎(chǔ)上修改可以避免這種問(wèn)題。parasnullunit、enumListpropertyName、dataType、required、min、max、step、maxLength、method、unit、enumList共十個(gè)維度，不能搞Profile文件校驗(yàn)失敗。ProfileProfile文件中一些字段的取值經(jīng)常有較多伙伴咨詢，這些字段的具體描述請(qǐng)見(jiàn)《中國(guó)電信物聯(lián)網(wǎng)開(kāi)放平臺(tái)_profileSwitch是開(kāi)關(guān)，彩燈option可以取值為option可以取值Master；顏色并不影響ColorOptional。float還是double。ProfileProfileSPportal上傳的時(shí)候可能會(huì)報(bào)錯(cuò)，下上傳文件必須是.zip文件解決辦