一、案例背景说明:
(一)接入方案:设备直连智城云方案
(二)模组:智城云通用WiFi模组
(三)客户端:智城云一键生成
本文档以空调为例,详细介绍产品的接入流程,智能硬件厂商可按照该文档进行开发、调试
二、产品需求:
(一)空调基本功能(智城云标准属性模板)
(二)告警功能
(三)厂商自定义开发H5设备界面
三、接入流程:

(一)注册账号

填写注册账号基本信息,点击“注册”按钮,跳转至补充企业信息页面:

点“提交”按钮后,等待智城云工作人员审核,一般审核时长为7个工作日内,如有特殊需求,请联系:zcyun@iiot.ac.cn
(二)企业管理人员创建子账号
账号注册审核通过后,默认为企业的超级管理员账号,该账号拥有智能云平台全部权限。企业超级管理员负责创建企业内其他角色的账号,针对产品接入来说,至少需要研发人员、研发管理员两个角色。

(三)产品研发
企业产品研发人员登录智能云,进入研发平台,开始产品开发:
1.创建产品

(1)产品基本信息
开发者登录平台后,产品列表分为两部分:我的产品、企业产品。我的产品指开发者参与研发的产品,开发者对其拥有查看、编辑的权限,企业产品指同企业内其他开发者研发的产品,当前开发者对其只有查看权限。
点击“创建新产品”按钮,进入产品基本信息页面,如下:

(2)产品属性信息
点击“保存并下一步”,进入配置产品属性页面,智城云提供标准属性模板供开发者直接使用,标准属性模板不满足需求时,开发者可增加自定义属性,智城云支持的属性类型包括开关型、数值型、枚举型、字符型、二进制型。

点击“下一步”,产品创建完成,提示开发者补充产品其他配置信息或开始硬件开发或产品UI开发,我们先去补充产品的其他配置信息。
(3)产品异常模板
为产品配置告警信息,当设备上报的数值在告警规则的阈值范围内时,给用户推送告警消息,保障用户正确、安全的操作设备。

(4)产品配网引导
该功能提供客户端添加设备时的配网引导页,包含图片+文字说明,指导用户快速添加设备,支持添加多个步骤的引导页。

2.设备界面H5开发

(1)下载标准UI资源
平台提供常见产品的标准UI模板

(2)在其基础上自定义开发
下载标准UI资源模板后,参照H5自定义开发指南,开发者可迅速上手并完成开发。
(3)上传自定义

(4)验证
使用企业超级APP添加真实设备或虚拟设备,配合平台上的验证功能,开发者可对H5进行调试验证。

3.硬件接入开发

4.联调测试
(1)设备调试
主控板与模组间通信调试:平台提供串口调试工具,连接设备与模组,按照使用说明发送指令进行验证
设备与客户端通信调试:客户端添加设备,通过客户端控制设备状态变化、设备状态变化上报,验证设备与客户端通信是否正常
(2)H5调试
使用企业超级APP(企业超级APP未生成之前可使用平台提供的调试助手)添加真实设备或虚拟设备,配合平台上的验证功能,开发者可对H5进行调试验证。
5.产品发布
产品调试通过后,可申请发布,提交申请后,经研发审核人员审核,审核通过后即发布。
(四)APP研发

1.基础定制
企业APP研发人员在智能云平台上填写APP基本信息,包括应用名称、版本号、应用图标、版权信息、注册协议等内容。
2.功能定制
提供APP功能包,企业根据自身需求进行定制化选择。
启动页:非必选,用户勾选时,可上传体现企业形象或企业产品宣传的自定义广告页。不勾选时,使用默认图片。
首页:APP首页,有以下功能可以选择,其中设备添加、设备列表属于APP基本功能,为必选项,不可取消勾选。点击各功能项,跳转至云市场页面,可查看各功能项详细介绍与展示。

商城:推荐企业选择,商城支持两种方案,一是使用智城云的商城方案,二是使用企业的自建商城。
发现:虚拟体验为必选,在客户没有智能设备的情况下,可以使用该功能体验智能设备的功能,其他功能包括但不限于智慧生活内容、云菜谱、空气质量等。
我:功能包括账户系统、我的消息、售后服务、检测新版本。
3.APP试用
经过前2步之后,可以提交APP信息生成试用版,试用版带有智城云水印,仅供企业内部体验使用,不可以发布推广

4.APP审核
APP试用版体验后可申请生成正式版,生成正式版需要经过智城云审核

5.APP发布
正式版APP经智城云审核通过后,通过企业智能云平台进行发布(iOS需要将安装包手动上传至APP Store上架),普通用户即可下载到企业超级APP。
