2022年阿里智能平台接入流程文档 .pdf

《2022年阿里智能平台接入流程文档 .pdf》由会员分享，可在线阅读，更多相关《2022年阿里智能平台接入流程文档 .pdf（25页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、阿里 IOT 平台方案流程简述1.接入流程示意图名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 1 页，共 25 页 - - - - - - - - - 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 2 页，共 25 页 - - - - - - - - - 2. 创建产品厂商登录后台后进入菜单“产品管理”-“产品列表”直接开始注册方案商登录后台后，进入菜单“客户管理”-“

2、客户列表”-“进入厂商工作台”才能看到菜单“产品管理”-“产品列表”直接开始注册。2.1 创建步骤详细注册过程详见，产品基本信息 - 功能定义- 界面开发 - 设备开发- 产品发布；2.2 填写基本信息功能项取值取值说明产品品牌默认申请签约时填写的企业英文简称产品类别下拉可选如：生活类 -空调，产品类别由平台定义，智能生活开放平台已不再支持新品类的接入产品型号自定义如： ALIWONDERFUL-1，产品在厂家内部的标识，请只用字母数字组合，勿用中文和特殊字符入网方式下拉可选按照设备的实际连接方式来选择，包括Wi-Fi 、bluetooth （蓝牙）、GPRS 、433 、zigbee 、 A

3、ndroid屏。模组型号下拉可选只有完成认证的模组型号会在下拉中显示，既需要完成模组的认证。目前支持的模组请见 模组列表认证方式DeviceID 设备端连接云端时，用DeviceID这个参数进行设备身份的认证白名单设备端连接云端时，用您上传的白名单（mac 或者 sn）这个参数进行设备身份的认产品信息产品信息产品功能产品功能界面开发界面开发设备开发设备开发产品发布产品发布名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 3 页，共 25 页 - - - - - - - - - 证认证固

4、件版本默认模组商每款认证的模组型号均有对应的固件版本号，默认显示，请确认即可。产品名称自定义可以填写线上销售的宝贝名称，或者用于管理时清晰能分辨产品的依据。产品图片上传产品图片用于APP 上操作时展示用途，可以自行确定产品描述填空项功能简单说明，非必填填写产品基本信息和产品信息图示如下，请务必参照上面说明注册。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 4 页，共 25 页 - - - - - - - - - 产品信息填写完之后，点击“ 保存并下一步” ，开始填写产品功能定义2.

5、3 填写产品功能定义完成 产品信息 之后，需要提交功能属性，也就是对这款智能产品的基本定义，平台已经将每一类设备（空调、空净、烤箱）的功能都做了统一规范，您可以根据自己设备的定义，从功能库中勾选自己设备需要的功能。页面弹出功能属性选项（包括必选和可选），如下图显示（以空调品类为例）：名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 5 页，共 25 页 - - - - - - - - - 您可以根据自己设备的定义，从可选产品功能列表中点击设备需要的属性（如上图），也可添加自定义属性（如

6、下图-页面右下入口）下面主要对添加自定义属性进行说明如果选择自定义，出现如上图所示输入框，示例填写如下：名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 6 页，共 25 页 - - - - - - - - - 属性名称：对属性的功能描述，如：开关；属性：对属性的变量定义，如：Power_OnOff 数据类型：根据实际选择枚举值：数据格式-属性值（属性名称），比如1（关闭）；填写这项需注意每个属性值输入以后，请敲回车或鼠标点击其他空白处，显示绿背景色并有X符号方为输入成功；数据传输类型

7、：根据实际选择说明：备注其他内容，非必填填完之后，点击“确定”提交！2.4 完成注册完成注册后可以通过菜单“产品管理”-“产品列表”，查看各产品的状态，如果要查看产品详情请点击“查看详情”。3.1 查看产品详情查看产品详情的入口：进入菜单“ 产品管理 ” -“ 产品列表 ” ，选择具体某款产品后，点击后面的“ 查看详情 ” 。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 7 页，共 25 页 - - - - - - - - - 3.2 信息详情展示1.目前信息主要包含4 部分的内容

8、，分别是基本信息，属性信息，注册信息，产品文档和开发辅助。2.功能定义名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 8 页，共 25 页 - - - - - - - - - 3.注册信息：提供平台对接的线上的Key 和 Secret ；请务必保证Key 和 Secret 的安全性4.产品文档和开发辅助4.1 管理 APP APP 开发者需按下面这个流程进行开发工作：名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师

9、精心整理 - - - - - - - 第 9 页，共 25 页 - - - - - - - - - 4.2 创建 APP 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 10 页，共 25 页 - - - - - - - - - 1. 点击创建 APP ，简单填写好APP名称及简介，就会自动生成APP key （iOS AppKey和Android AppKey ）2.创建成功后如图展示名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - -

10、- - - - 名师精心整理 - - - - - - - 第 11 页，共 25 页 - - - - - - - - - 4.3 获取 APP安全证书 (无证书无法正常使用， 需要到阿里云申请) 5. 1 APP集成 ADK 详情参考Android 开发手册6.1 配置消息推送具体配置页面如下，安卓只需要填写packageName 保存， iOS需要设置APNs推送证书及密码名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 12 页，共 25 页 - - - - - - - - - 6

11、.1 界面开发定制开发接入的产品设备控制页面，可以根据实际需要，选用 标准面板 或自主开发面板，并进行后续操作。6.2 标准面板1.标准面板是阿里IOT基于该品类通用特征进行开发的标准化产品，无需二次开发，仅简单进行 UI 配置即可投入使用；名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 13 页，共 25 页 - - - - - - - - - 2. 按照页面引导，安装Demo App,并注册帐号，正确填写后，显示如下：名师资料总结 - - -精品资料欢迎下载 - - - - -

12、- - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 14 页，共 25 页 - - - - - - - - - 3. 继续操作下一步，会弹框二次确认：名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 15 页，共 25 页 - - - - - - - - - 点击 “ 确定 ” 后，页面自动跳转到下一步，这个页面上展示了3 部分内容：提示文案，在页面上点击集成配置的开发文档 ,可以获取到开发文档。3. UI 功能配置（标准功能）（自定义功能

13、），注意右上角有编辑入口，可以名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 16 页，共 25 页 - - - - - - - - - 操作。如果功能确认已经无需修改，并且面板调试ok 的情况下，直接点击“ 下一步 ” ，即将进入设备开发 阶段。6.3 自主开发面板1.界面开发选择自主开发面板名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 17 页，共 25 页 - -

14、- - - - - - - 2.在页面上点击参考文档 , 可以获取到开发文档。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 18 页，共 25 页 - - - - - - - - - 3.只有输入您当前开发App中注册的账号后，才可以使用App调试工具。左边为推送设备消息功能，可以指定方法和数据下发给App （模拟设备上报数据给云端，然后云端推送给 App的过程），右边为通知可以下发指定通知给App端（模拟云端推送通知给App），如果出现页面显示通知下发成功，但App的端未收到通知

15、的情况，请确认app 管理中配置消息推送是否正确4.界面文件包上传框中，点击“”后，可从本地选择压缩包上传，点击“立即上传”，会如下提示名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 19 页，共 25 页 - - - - - - - - - ps: 上传的面板压缩包 （必须是 .zip格式），并且压缩包文件名必须是 “BoneKit Code ”处显示的 MODEL。5. 输入在 app 调试过程中，绑定了设备的帐号后, 点击“下一步”，即将进入设备开发阶段。7.1 设备开发1.目

16、前设备实际的调试工作并不在控制台进行，因此流程到这里只是作为核对产品 TRD ，核对注册的产品型号，并记录线上Key 和 secret 用于实际设备调试使用，同时提供模拟App端下发功能用于设备调试。页面如图：名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 20 页，共 25 页 - - - - - - - - - 7.2 模拟 App 端下发调试1.输入您当前开发 App中注册的账号后， 会根据当前流程信息查询到该账号绑定的设备，点击标记为测试后即可进行设备调试 （如果当前用户为该

17、设备管理员，默认会进入到设备调试状态）。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 21 页，共 25 页 - - - - - - - - - 2.指令下发分为两种类型，可视化下发与自定义下发，两者主要区别是自定义下更加灵活。指令下发支持Set（更新设备状态）和Get（获取设备状态），默认为 Set， 通过勾选要下发的属性和属性值后，点击一键下发即可更新设备状态。如果需要获取设备状态， 只要将下方的 Set 选择成 Get 后，并勾选你需要获取的属性，然后点击一键下发即可。 当这

18、些操作完成后， 相关的日志就会打印在右边的实时日志栏中。3.自定义下发可以指定方法和参数进行下发，Set（更新设备状态）默认模板采用 setDeviceStatus方法，你可以根据模板和当前开发设备的属性进行参数拼接一键下发即可。如果需要使用其他方法， 可以变更 method与 params中的内容，完成后一键下发即可。 Get（获取设备状态）则是在attrSet中写入要获取的属性后一键下发即可，相关日志同样会打印在右边的实时日志栏中。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第

19、22 页，共 25 页 - - - - - - - - - 4. 右边日志栏分为全量实时日志和变更实时日志，这两者的区别主要在于设备上报日志数据的显示。 当设备上报更新状态后， 实时日志会打印出设备上报的状态数据，全量实时日志会打印出所有的设备状态而变更实时日志只会打印变更的属性和属性值，方便不同的调试需求。5. 底部的设备原始数据， 可以查看消息推送后的状态， 可以选择时间区间段查询最近 100 条该设备相关的推送日志， 如果有日志数据需要相关人员辅助排查问题时，可以选择保存日志功能将当前日志保留，然后通过查看历史记录功能查看保存日志6 设备开发完成后，直接点击“下一步”，即将进入产品发布阶

20、段。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 23 页，共 25 页 - - - - - - - - - 8.1 产品发布1.创建产品到这一步已经是最后一步，按照页面提示配置好设备配网激活内容后，就可以发布上线了。请注意，谨慎填写设备配网激活内容，并且确保您填写的内容跟设备固件一致。在调试时，设备初始化操作后，能上报对应的属性值，触发配网如果暂时不需要发布上线，您可以先在填写好配网后，点击“保存”，当您点击“发布上线”，页面会有个确认框显示：名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 24 页，共 25 页 - - - - - - - - - 恭喜您， 第一次 IoT 定制开发的旅程到此结束了，欢迎您多向我们提供宝贵的建议，帮助我们优化！名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 25 页，共 25 页 - - - - - - - - -