电信物联网开放平台北向应用quickstart

北向应用中国电物联二〇二一北向应用中国电物联二〇二一编：：： 中国电 物联 运营目录1234开发者必 求助方 前期准 目录1234开发者必 求助方 前期准 开发环境准 安装 配置Java环境变量（Windows操作系统 安装 56789调用鉴权接口，获取 订 消 直连设 上传Profile资源包样 根据Profile修改设备信 绑定设备（设备上线 创建设备命 设备数据上报 命令下 样例附 附 14.1使 tman测 14.2单步调测、查看消息内 应用集成调测典型问题分 1开发者必LiteDemo，比对发给平1开发者必LiteDemo，比对发给平2求助方开发求助方3前期准获取中国电信物联网开对接信应用对接 IP和端3前期准获取中国电信物联网开对接信应用对接 IP和端和 4开发环境准javaJDK、配置环境变量、安装Eclipse的方法。如果java，请自行准备开发环境。Java环境变量（Windows操作系统）Eclipse4.1请务必安装JDK1.8版本。JDK1.8请务必安装JDK1.8版本。JDK1.84.2Java环境变量（Windows操作系统PATH存在，另外两个变量需要新lib，biniles\Jaa\jdk1.8._45\bin能识别。CLASSPATH的取值为“.;%JAHOM%能识别。CLASSPATH的取值为“.;%JAHOM%\lib\dt.jar;%JAHOE%\lib\tool.jar.DOS命令来检查环境变量是否配置成功。打开C:\Users\username>javacusername4.3.Eclipse版本和jdk必须都是32位的，或者都是64找不到jvm.dll4.44.4Next（JavaProject为例，可以根据实际情况选择其他工程，如果您已有自己4.54.5 JavaBuildPathLibrariesAddJARs，进入工程目录\Opensourcecomponentsjar，最后点OK。。5调用鉴权接口，获取。5调用鉴权接口，获取IP端口、 如果样例代码的注解中出现“pleasereplace”的字样，开发者需要根据实际情况修改常量或变量修改完全局常量后，如下图所示，右击Authentication.javaRunAsJava如果样例代码的注解中出现“pleasereplace”的字样，开发者需要根据实际情况修改常量或变量修改完全局常量后，如下图所示，右击Authentication.javaRunAsJava8.2章节的内容进行单步调测。 sToken会在expiresIn所标志的时间内过期，expiresInacsToken过期后需要重新获取。可以使用鉴权接口重新获取，也可以使用上一次鉴权得到的refreshToken来获取新的acsToken。RefreshToken接口请参考APIacsToken过期后需要重新获取。可以使用鉴权接口重新获取，也可以使用上一次鉴权得到的refreshToken来获取新的acsToken。RefreshToken接口请参考API文档和样例代码中的LiteDemo中还提供了各接口调用的抓包示例，参6订消将设备消息分类推送给北向应用（API文档中“Application订阅数据”的接口说明（即回调地址）IoT，Constants.javaCALLBACK_BASE_URLIP和端口（回调地址中Authentication.javaRunAsJavaApplication，就可以在控制台看到响应消如需修改订阅的回调地址，在Constants.java类中修改各回调地址的值，再次订阅即可。新的订阅完成后，开发者可参考SubscribeNotifyResource.java搭建一个应用服务器来接推如需修改订阅的回调地址，在Constants.java类中修改各回调地址的值，再次订阅即可。新的订阅完成后，开发者可参考SubscribeNotifyResource.java搭建一个应用服务器来接推送t消息。和查看回调内容，可以使用LiteDemo提供的类TestSubscribeAllNotification.java，下文在7直连设verifyCode/nodeId需要与真实设备的唯一标识符（IMEIMAC）一致。如果使用的是模拟器设备，则verifyCode可以是数字、字母和特殊符号的组合，开发者可verifyCode重复（本文使用模拟器设备。timeouttimeout=verifyCode/nodeId需要与真实设备的唯一标识符（IMEIMAC）一致。如果使用的是模拟器设备，则verifyCode可以是数字、字母和特殊符号的组合，开发者可verifyCode重复（本文使用模拟器设备。timeouttimeout=>RegisterDirectlyConnectedDevice.javaRunAsJavaApplication，就由于LiteDemo中没有建立数据库，需要手动拷贝并保存deviceId设备接口则可刷新deviceId设息。具体使用方法请参考QueryDeviceData.java、 .java及API文档 8上传Profile资源包样SPportal后，在设备管理->模型-> 8上传Profile资源包样SPportal后，在设备管理->模型->导入模型页面上传本文档使用Profile资源包直接导入 9根据Profile修改设备信NB-IoT设备，protocolTypeCoAP，另外三个字段可自行定义，ProfileWaterMeter、sew、n001。ModifyDeviceInfo.javaRunAsNB-IoT设备，protocolTypeCoAP，另外三个字段可自行定义，ProfileWaterMeter、sew、n001。ModifyDeviceInfo.javaRunAsJavaApplication，就可以在控制台此接口使用到的deviceId设备，获得新的deviceId，否则修改设备信息时会出错根据manufacturerId和来找到设备对应的Profile息的配。一个北向应用可以添加多种型号的设备，每种型号对应一个Profile。在修改了设备信息后，设备被赋予了Profile中所配置的设备能力。信息。具体使用方法请参考QueryDeviceData.java、QueryDevi .java及API文档。 10绑定设备（设备上线绑定设备，即设备首次上线的动作。设备上报的数据中携带设备标识符（IMEI 10绑定设备（设备上线绑定设备，即设备首次上线的动作。设备上报的数据中携带设备标识符（IMEI或Mac地成功并 的verifyCode/nodeId匹配起来，则绑定成功，设备插态就变成online是开发者Portal提供的模拟设备。verifyCode保持一致verifyCode保持一致在模拟器控制台页面，选择Set在模拟器控制台页面，选择Set.javaAPI 11创建设备命LiteDemomandV4.java，将修改deviceId 11创建设备命LiteDemomandV4.java，将修改deviceId->下发请参考Step10。执行结果推送到该回调地址。详见该接口的callbackUrl字段。设备数据上报命令下设备数据上报命令下HTTP服务器。打开NotifyType.java，修改TEST_CALLBACK_BASE_URL常量中的IP和端口。Demo使用的简单的HTTP服务器只 本地端口，TEST_CALLBACK_BASE_URL中不能->aaterMetertmanWebAPI&tmanWebAPI&HTTP以用来调用APIAPPserverLiteDemo相似的功能，IDE。使 tman测14.1tmantman或者HTTP使 tman测14.1tmantman或者HTTP HTTPIP的HTTPtman鉴权接http方法、URLhttp方法、URLURLhttps修改为httportiphttp直连直连设备接http方法、URL修改设修改设备信息接http方法、URLSend14.2Send14.2http/https消息的代码处打上断点，以便调试，如在样例代码HttpsUtil.java中的executeHttpRequest3个断点（请根据您代码的实际情况打：（uthen（uthentcation.ava Variablesrequest变量。选中request变量时，可以在下方内容展示区看URL。在entity中可以看到发出去的消息内容。secret在contentsecret在content字段内，使用了十进制的ASCIIResponse如果调用的类不是Authentication.java，由于第一次发的消息为使用如果调用的类不是Authentication.java，由于第一次发的消息为使用按钮使程序向下运行，直到断点再第二次命中executeHttpRequest中发送http/https消息的地方，使用StepOver按钮运行到如下图所示的位置再查看变量内容。ResponseResponse 15应用集成调测典 15应用集成调测典型问题分15.1ProfileProfile文件的编写是较容易出现问题的地方，本节通过介绍常见的问题，从而增加开Profile文件的认识，进而避免问题的发生。ProfileProfile文件模版直接修改。Profile文件的格式多，字根据与伙伴APPserver如何理解Profile文件服务的定Profile写作的遇到的第一个问题就是如何定义一个服务。当前服务的定义没有明确的Profile文件是一款设备的根据与伙伴APPserver如何理解Profile文件服务的定Profile写作的遇到的第一个问题就是如何定义一个服务。当前服务的定义没有明确的Profile文件是一款设备的APPserver不关心，也可以不定义。彩灯是智能彩灯，APPserver可以通过命令控制彩灯，将智能功能归纳为一种服务也Profile文件的格式问ProfileProfile文件格式的梳理，Profile编写者的理解。ProfilejsonProfile文件对 json格式校些Profilezip有伙伴以rar打包后，手动更改后缀名，导致 ype_IoTprofile开发指南》对其进行赋值。每一个命令中的字段都Profile文件模版的基础上修改可以避免这种问题。Profile文件字段的取值说Profile文件字段的取值说Profile文件上传问上传文件必须是.zip文件 其中Switch是开关，彩灯option可以取值为读，因此option可以取值为Master；颜色并不影响附属的属性，因此Color可以定义为Optional。 floatdouble。存在存在manufacturerId都一样。和mmjson15.2API接口的调用需要一定http协议的知识，这样不仅方便进行接口的调用，而且可以快速进行问题定界。比如调用接口返回https uscode为400，就需要排查是否请求结有可选参数的接口调15.2API接口的调用需要一定http协议的知识，这样不仅方便进行接口的调用，而且可以快速进行问题定界。比如调用接口返回https uscode为400，就需要排查是否请求结有可选参数的接口调用问