产品定义 及 机智云平台接入教程

Genius

目录
一、产品接入前提
二、创建新产品
三、通过新设备接入向导完成设备配置

• 编辑数据点
  
• MCU编程
  
• 设备调试
  
• 完成并退出向导
  
  

四、通过方案模板创建产品
五、产品管理

• 产品删除
  
• 数据点
  
• 虚拟设备
  
• 运行状态
  
• 产品开发资源
  
  

一、产品接入前提

在使用机智云服务之前，你首先需要在机智云开发者中心注册一个开发者账号并登录。注册详细操作说明请参考注册机智云账号。

二、创建新产品

步骤一：点击机智云官网导航栏的“硬件接入”进入”设备列表“页面（http://site.gizwits.com/zh-cn/developer/product），点击页面设备列表栏的【+ 创建新产品】按键，弹出添加产品弹框，如图：

步骤二：按照添加产品弹框内的提示填写或选择产品基本信息，点击【添加】，进入“新设备接入向导—编辑数据点”页面

三、通过新设备接入向导完成设备配置编辑产品数据点

方法一：通过方案模板创建生成产品数据点

前提：用户所拥有的方案模板不为空

步骤1: 从“新设备接入向导—编辑数据点”页面显示的模板列表中选择与新产品类似的方案模板，点击方案模板上的【查看】可以查看方案模板的详细数据点列表，点击数据点列表弹框下的【关闭】，可以关闭数据点列表弹框，如图：

步骤2：点击方案模板中【应用此模板】按键，弹出提示框，点击提示框上的【添加】即可将模板数据点应用到新的产品，如图：

步骤3：通过方案模板创建生成数据点成功，自动跳转到手动编辑数据点页面，可以对生成的数据点进行编辑、添加或删除。

数据点添加，编辑和删除具体操作详情请见数据点定义

方法二：手动编辑产品数据点

如果当前用户没有模板或者没有合适的模板，或用户不想使用模板创建产品数据点时，此时用户可以根据新产品的功能手动逐个进行数据点的添加。

步骤1：点击“新设备接入向导—编辑数据点”页面的手动编辑数据点选项，进入手动编辑数据点页面。

步骤2：点击手动编辑数据点页面的【+新建数据点】按钮，弹出添加数据点弹框。根据提示填写数据点信息并保存，系统将为你的产品创建第一个数据点，你可以继续对数据点进行微调。

步骤3：重复步骤2的添加操作，直到产品功能需要的数据点全部添加完成。对生成的产品数据点你可以继续执行编辑，删除以及添加操作。

MCU编程

数据点编辑完成后，点击【下一步】，页面自动跳转到“新设备接入向导—MCU编程”页面，页面显示如下：

根据上一步添加的产品数据点，页面自动生成了《XX-机智云接入串口通信协议文档》和《XX-机智云接入JSON文档》（其中XX代表产品名称），点击文档名即可进行下载，硬件开发人员只需按照文档指示即可轻松完成硬件开发。

设备调试

点击“新设备接入向导—MCU编程”页面的【下一步】，进入“新设备接入向导—设备调试”页面，页面包含产品开发资源和轻应用开发资源两项。

产品开发资源项：

产品开发资源提供android和iOS SDK,集成文档以及Demo APP的下载。

当完成了产品数据点编辑后且产品的硬件设备已开发完成，可下载对应的SDK集成到已完成界面设计的移动应用，即可实现设备的控制。同时也可以直接下载并安装Demo App，登录后即可对连接并查看、控制设备。如果设备未完成开发，可以使用机智云提供的虚拟设备进行功能的调试。

虚拟设备调试详细说明请戳调试工具

轻应用开发项：

轻应用开发项提供API文档的查看链接，点击即可跳转到API文档说明页面。

使用机智云提供的Open APIs（Http / WebSocket），可以快速开发网页或微信应用等基于html的轻应用，用于管理和控制智能设备。

完成并退出向导

至此，你已完成了一款智能硬件产品的接入，接下来你将进入此设备页面，你可以直接申请发布，也可以继续编辑、查看,删除或调试设备。

四、通过方案模板创建产品

机智云为广大开发者提供了一系列方案模版，当选择相同产品时可选择直接套用模版，更高效的定义产品。

步骤1：点击机智云导航栏的“硬件接入”进入设备列表页面，点击页面右侧导航栏的“方案模板”选项进入方案模板页面：http://site.gizwits.com/zh-cn/developer/product

步骤2：在方案模板页面显示的模板列表中选择自己需要用到的模板，点击【应用此模板】，弹出使用方案模板创建新设备弹框，如图：

五、产品管理

设备正式上线之前，都可以对设备信息进行修改。只有拥有产品的管理员或开发者权限，才能对产品进行编辑。设备识别码是你的新设备在机智云中的唯一标识，由系统自动生成，无法更改。

产品信息查看和编辑

步骤1:进入产品管理页面,页面默认显示产品信息，如图：

步骤2：点击产品详细信息栏后的编辑图标，进入产品信息编辑页面，如图：

步骤3：修改产品信息，点击【保存】，修改成功，页面自动跳转到产品详情信息页面，产品详情变更为修改后的产品信息

产品删除

为方便广大开发者的产品管理，可以把暂时不需要用到的产品移至回收站。无论是产品被删除至回收站，还是存在于设备列表中，产品本身数据点及名称、应用属性等数据均不会改变，依旧可以正常使用。

进入产品信息编辑页面，点击页面的【删除】，弹出删除确认提示框，点击提示框内【确定】，即可將产品移至回收站，如图：

同时，为保证产品在使用上不受影响，删除的产品也可以在回收站中进行还原操作。

数据点

已进入产品管理页面，点击产品管理页面的”数据点“选项，进入产品数据点页面，如图：

可继续对产品数据点执行添加，编辑，删除动作，也可以将此设备的数据点方案另存为模板，在开发同类型设备时可重复使用。数据点具体操作请戳数据点定义。

虚拟设备

点击产品管理页面的”虚拟设备“选项，进入虚拟设备页面。点击页面【启动虚拟设备】，即可登录虚拟设备

虚拟设备具体使用请戳调试工具

运行状态

点击产品管理页面的”运行状态“选项，进入运行状态页面，实时显示设备信息，可以辅助调试：

产品开发资源

点击产品管理页面的”产品开发资源“选项，进入产品开发资源页面，显示产品开发资源，MCU开发资源，轻应用开发资源3项：