产品定义 及 机智云平台接入教程
本帖最后由 Genius 于 2016-7-7 15:26 编辑目录
一、产品接入前提
二、创建新产品
三、通过新设备接入向导完成设备配置
[*]编辑数据点
[*]MCU编程
[*]设备调试
[*]完成并退出向导
四、通过方案模板创建产品
五、产品管理
[*]产品删除
[*]数据点
[*]虚拟设备
[*]运行状态
[*]产品开发资源
一、产品接入前提在使用机智云服务之前，你首先需要在机智云开发者中心注册一个开发者账号并登录。注册详细操作说明请参考注册机智云账号。
二、创建新产品步骤一：点击机智云官网导航栏的“硬件接入”进入”设备列表“页面（http://site.gizwits.com/zh-cn/developer/product），点击页面设备列表栏的【+ 创建新产品】按键，弹出添加产品弹框，如图：https://gizwits.kf5.com/attachments/download/525142/00156e9253d3daa7741ba8da86650c0/步骤二：按照添加产品弹框内的提示填写或选择产品基本信息，点击【添加】，进入“新设备接入向导—编辑数据点”页面https://gizwits.kf5.com/attachments/download/525144/00156e9256082644252be7aa9e365ad/
三、通过新设备接入向导完成设备配置编辑产品数据点方法一：通过方案模板创建生成产品数据点前提：用户所拥有的方案模板不为空步骤1: 从“新设备接入向导—编辑数据点”页面显示的模板列表中选择与新产品类似的方案模板，点击方案模板上的【查看】可以查看方案模板的详细数据点列表，点击数据点列表弹框下的【关闭】，可以关闭数据点列表弹框，如图：https://gizwits.kf5.com/attachments/download/525152/00156e9259c17617bb3270d506a2fdb/步骤2：点击方案模板中【应用此模板】按键，弹出提示框，点击提示框上的【添加】即可将模板数据点应用到新的产品，如图：https://gizwits.kf5.com/attachments/download/525161/00156e925eee245c2b4f39dfbb644cf/步骤3：通过方案模板创建生成数据点成功，自动跳转到手动编辑数据点页面，可以对生成的数据点进行编辑、添加或删除。数据点添加，编辑和删除具体操作详情请见数据点定义方法二：手动编辑产品数据点
如果当前用户没有模板或者没有合适的模板，或用户不想使用模板创建产品数据点时，此时用户可以根据新产品的功能手动逐个进行数据点的添加。步骤1：点击“新设备接入向导—编辑数据点”页面的手动编辑数据点选项，进入手动编辑数据点页面。https://gizwits.kf5.com/attachments/download/525174/00156e9263d2bcd7d439f3bf4ae98da/步骤2：点击手动编辑数据点页面的【+新建数据点】按钮，弹出添加数据点弹框。根据提示填写数据点信息并保存，系统将为你的产品创建第一个数据点，你可以继续对数据点进行微调。https://gizwits.kf5.com/attachments/download/525179/00156e9265f1065525166aff64fcc87/步骤3：重复步骤2的添加操作，直到产品功能需要的数据点全部添加完成。对生成的产品数据点你可以继续执行编辑，删除以及添加操作。
MCU编程
数据点编辑完成后，点击【下一步】，页面自动跳转到“新设备接入向导—MCU编程”页面，页面显示如下：https://gizwits.kf5.com/attachments/download/525183/00156e9268547d50852d3940f628143/根据上一步添加的产品数据点，页面自动生成了《XX-机智云接入串口通信协议文档》和《XX-机智云接入JSON文档》（其中XX代表产品名称），点击文档名即可进行下载，硬件开发人员只需按照文档指示即可轻松完成硬件开发。
设备调试点击“新设备接入向导—MCU编程”页面的【下一步】，进入“新设备接入向导—设备调试”页面，页面包含产品开发资源和轻应用开发资源两项。产品开发资源项：https://gizwits.kf5.com/attachments/download/525186/00156e926cc8a6e1eba022d228404fb/产品开发资源提供android和iOS SDK,集成文档以及Demo APP的下载。当完成了产品数据点编辑后且产品的硬件设备已开发完成，可下载对应的SDK集成到已完成界面设计的移动应用，即可实现设备的控制。同时也可以直接下载并安装Demo App，登录后即可对连接并查看、控制设备。如果设备未完成开发，可以使用机智云提供的虚拟设备进行功能的调试。虚拟设备调试详细说明请戳调试工具轻应用开发项：https://gizwits.kf5.com/attachments/download/525189/00156e92708ac34f7adfc8e4ee593bd/轻应用开发项提供API文档的查看链接，点击即可跳转到API文档说明页面。使用机智云提供的Open APIs（Http / WebSocket），可以快速开发网页或微信应用等基于html的轻应用，用于管理和控制智能设备。
完成并退出向导至此，你已完成了一款智能硬件产品的接入，接下来你将进入此设备页面，你可以直接申请发布，也可以继续编辑、查看,删除或调试设备。
四、通过方案模板创建产品机智云为广大开发者提供了一系列方案模版，当选择相同产品时可选择直接套用模版，更高效的定义产品。步骤1：点击机智云导航栏的“硬件接入”进入设备列表页面，点击页面右侧导航栏的“方案模板”选项进入方案模板页面：http://site.gizwits.com/zh-cn/developer/producthttps://gizwits.kf5.com/attachments/download/525193/00156e92797574ec16082d8ee50f052/步骤2：在方案模板页面显示的模板列表中选择自己需要用到的模板，点击【应用此模板】，弹出使用方案模板创建新设备弹框，如图：https://gizwits.kf5.com/attachments/download/525195/00156e927b59502c11876fb303b27bf/
五、产品管理设备正式上线之前，都可以对设备信息进行修改。只有拥有产品的管理员或开发者权限，才能对产品进行编辑。设备识别码是你的新设备在机智云中的唯一标识，由系统自动生成，无法更改。产品信息查看和编辑步骤1:进入产品管理页面,页面默认显示产品信息，如图：https://gizwits.kf5.com/attachments/download/525200/00156e927da67f3932fb4844502838f/步骤2：点击产品详细信息栏后的编辑图标，进入产品信息编辑页面，如图：https://gizwits.kf5.com/attachments/download/525205/00156e927fff0681332fac0ad3cda4c/步骤3：修改产品信息，点击【保存】，修改成功，页面自动跳转到产品详情信息页面，产品详情变更为修改后的产品信息产品删除
为方便广大开发者的产品管理，可以把暂时不需要用到的产品移至回收站。无论是产品被删除至回收站，还是存在于设备列表中，产品本身数据点及名称、应用属性等数据均不会改变，依旧可以正常使用。进入产品信息编辑页面，点击页面的【删除】，弹出删除确认提示框，点击提示框内【确定】，即可將产品移至回收站，如图：https://gizwits.kf5.com/attachments/download/525207/00156e92824eed8436dcea486f3e4fa/同时，为保证产品在使用上不受影响，删除的产品也可以在回收站中进行还原操作。数据点已进入产品管理页面，点击产品管理页面的”数据点“选项，进入产品数据点页面，如图：https://gizwits.kf5.com/attachments/download/525214/00156e92874cb9398ae08ccc240f342/可继续对产品数据点执行添加，编辑，删除动作，也可以将此设备的数据点方案另存为模板，在开发同类型设备时可重复使用。数据点具体操作请戳数据点定义。虚拟设备点击产品管理页面的”虚拟设备“选项，进入虚拟设备页面。点击页面【启动虚拟设备】，即可登录虚拟设备https://gizwits.kf5.com/attachments/download/525223/00156e928e00f7e8117a8b528ca541a/虚拟设备具体使用请戳调试工具
运行状态点击产品管理页面的”运行状态“选项，进入运行状态页面，实时显示设备信息，可以辅助调试：https://gizwits.kf5.com/attachments/download/525234/00156e929399a8620f6a4b28c6ae767/
产品开发资源点击产品管理页面的”产品开发资源“选项，进入产品开发资源页面，显示产品开发资源，MCU开发资源，轻应用开发资源3项：https://gizwits.kf5.com/attachments/download/525239/00156e9296f0878a91ba2e19131312b/
页:
[1]