当前位置:文档之家› 阿里智能平台接入流程文档

阿里智能平台接入流程文档

阿里IOT平台方案流程简述1.接入流程示意图
2. 创建产品
厂商登录后台后进入菜单“产品管理”-“产品列表”直接开始注册
方案商登录后台后,进入菜单“客户管理”-“客户列表”-“进入厂商工作台”才能看到菜单“产品管理”-“产品列表”直接开始注册。

2.1创建步骤
2.2填写基本信息
产品信息 产品信息 产品功能 产品功能 界面开发 界面开发 设备开发 设备开发 产品发布
产品发布
填写产品基本信息和产品信息图示如下,请务必参照上面说明注册。

产品信息填写完之后,点击“保存并下一步”,开始填写产品功能定义
2.3填写产品功能定义
完成产品信息之后,需要提交功能属性,也就是对这款智能产品的基本定义,平台已经将每一类设备(空调、空净、烤箱…)的功能都做了统一规范,您可以根据自己设备的定义,从功能库中勾选自己设备需要的功能。

页面弹出功能属性选项(包括必选和可选),如下图显示(以空调品类为例):
您可以根据自己设备的定义,从可选产品功能列表中点击设备需要的属性(如上图),也可添加自定义属性(如下图-页面右下入口)
下面主要对添加自定义属性进行说明
如果选择自定义,出现如上图所示输入框,示例填写如下:
属性名称:对属性的功能描述,如:开关;
属性:对属性的变量定义,如:Power_OnOff
数据类型:根据实际选择
枚举值:数据格式-属性值(属性名称),比如1(关闭);填写这项需注意每个属性值输入以后,请敲回车或鼠标点击其他空白处,显示绿背景色并有X符号方为输入成功;
数据传输类型:根据实际选择
说明:备注其他内容,非必填
填完之后,点击“确定”提交!
2.4完成注册
完成注册后可以通过菜单“产品管理”-“产品列表”,查看各产品的状态,如果要查看产品详情请点击“查看详情”。

3.1查看产品详情
查看产品详情的入口:进入菜单“产品管理”-“产品列表”,选择具体某款产品后,点击后面的“查看详情”。

3.2信息详情展示
1.目前信息主要包含4部分的内容,分别是基本信息,属性信息,注册信息,产品文档和开发辅助。

2.功能定义
3.注册信息:提供平台对接的线上的Key和Secret;请务必保证Key和Secret的安全性
4.产品文档和开发辅助
4.1管理APP
APP开发者需按下面这个流程进行开发工作:
4.2创建APP
1.点击创建APP,简单填写好APP名称及简介,就会自动生成APP key(iOS AppKey和Android AppKey)
2.创建成功后如图展示
4.3获取APP安全证书(无证书无法正常使用,需要到阿里云申请)
5.1 APP集成ADK
详情参考Android开发手册
6.1配置消息推送
具体配置页面如下,安卓只需要填写packageName保存,iOS需要设置APNs推送证书及密码
6.1界面开发
定制开发接入的产品设备控制页面,可以根据实际需要,选用"标准面板"或"自主开发面板",并进行后续操作。

6.2标准面板
1.标准面板是阿里IOT基于该品类通用特征进行开发的标准化产品,无需二次开发,仅简单进行UI配置即可投入使用;
2.按照页面引导,安装Demo App,并注册帐号,正确填写后,显示如下:
3.继续操作下一步,会弹框二次确认:
点击“确定”后,页面自动跳转到下一步,这个页面上展示了3部分内容:
提示文案,在页面上点击集成配置的开发文档,可以获取到开发文档。

3.UI功能配置(标准功能)+(自定义功能),注意右上角有编辑入口,可以
操作。

如果功能确认已经无需修改,并且面板调试ok的情况下,直接点击“下一步”,即将进入设备开发阶段。

6.3自主开发面板
1.界面开发选择自主开发面板
2.在页面上点击参考文档,可以获取到开发文档。

3.只有输入您当前开发App中注册的账号后,才可以使用App调试工具。

左边为推送设备消息功能,可以指定方法和数据下发给App(模拟设备上报数据给云端,然后云端推送给App的过程),右边为通知可以下发指定通知给App端(模拟云端推送通知给App),如果出现页面显示通知下发成功,但App的端未收到通知的情况,请确认app管理中配置消息推送是否正确
4.界面文件包上传框中,点击“…”后,可从本地选择压缩包上传,点击“立即上传”,会如下提示
ps:上传的面板压缩包(必须是.zip格式),并且压缩包文件名必须是“BoneKit Code”处显示的MODEL。

5.输入在app调试过程中,绑定了设备的帐号后,点击“下一步”,即将进入设备开发阶段。

7.1设备开发
1.目前设备实际的调试工作并不在控制台进行,因此流程到这里只是作为核对产品TRD,核对注册的产品型号,并记录线上Key和secret用于实际设备调试使用,同时提供模拟App端下发功能用于设备调试。

页面如图:
7.2 模拟App端下发调试
1.输入您当前开发App中注册的账号后,会根据当前流程信息查询到该账号绑定的设备,点击标记为测试后即可进行设备调试(如果当前用户为该设备管理员,默认会进入到设备调试状态)。

2.指令下发分为两种类型,可视化下发与自定义下发,两者主要区别是自定义下更加灵活。

指令下发支持Set(更新设备状态)和Get(获取设备状态),默认为Set,通过勾选要下发的属性和属性值后,点击一键下发即可更新设备状态。

如果需要获取设备状态,只要将下方的Set选择成Get后,并勾选你需要获取的属性,然后点击一键下发即可。

当这些操作完成后,相关的日志就会打印在右边的实时日志栏中。

3.自定义下发可以指定方法和参数进行下发,Set(更新设备状态)默认模板采用setDeviceStatus方法,你可以根据模板和当前开发设备的属性进行参数拼接一键下发即可。

如果需要使用其他方法,可以变更method与params中的内容,完成后一键下发即可。

Get(获取设备状态)则是在attrSet中写入要获取的属性后一键下发即可,相关日志同样会打印在右边的实时日志栏中。

4.右边日志栏分为全量实时日志和变更实时日志,这两者的区别主要在于设备上报日志数据的显示。

当设备上报更新状态后,实时日志会打印出设备上报的状态数据,全量实时日志会打印出所有的设备状态而变更实时日志只会打印变更的属性和属性值,方便不同的调试需求。

5.底部的设备原始数据,可以查看消息推送后的状态,可以选择时间区间段查询最近100条该设备相关的推送日志,如果有日志数据需要相关人员辅助排查问题时,可以选择保存日志功能将当前日志保留,然后通过查看历史记录功能查看保存日志
6设备开发完成后,直接点击“下一步”,即将进入产品发布阶段。

8.1 产品发布
1.创建产品到这一步已经是最后一步,按照页面提示配置好设备配网激活内容后,就可以发布上线了。

请注意,谨慎填写设备配网激活内容,并且确保您填写的内容跟设备固件一致。

在调试时,设备初始化操作后,能上报对应的属性值,触发配网
如果暂时不需要发布上线,您可以先在填写好配网后,点击“保存”,当您点击“发布上线”,页面会有个确认框显示:
恭喜您,第一次IoT定制开发的旅程到此结束了,欢迎您多向我们提供宝贵的建议,帮助我们优化!。

相关主题