自定义开发快速入门

本文通过示例，为您介绍自定义开发业务体系下如何快速创建和配置云开发项目，以及对接涂鸦云开发的基本流程。

示例

例如，在云项目下新增资产并且在资产下添加设备，并使用 OpenAPI 和消息队列来查询用户和设备信息，并控制设备。

1. 成为开发者。
2. 创建和配置云项目。
3. 添加设备。
4. 开通消息订阅服务。
5. 开发&调试。
   a. 获取资产下的设备列表。
   b. 查询设备列表某个设备支持的功能指令。
   c. 向该设备下发指令。
   d. 通过消息订阅，监听指令产生的消息。

交互逻辑如下所示：

成为开发者

1. 进入涂鸦 IoT 开发平台 账号注册页面。

2. 根据页面提示，完成涂鸦智能开发者账号的注册。此账号拥有涂鸦 IoT 开发平台最高权限，请妥善保管。

   如果您是企业用户，可以参考 企业认证流程 完成企业认证。

创建和配置云项目

涂鸦云项目是涂鸦 IoT 开发平台设备、用户等开放数据的数据载体或集合。不同云项目之间的资源相互隔离。

1. 登录 涂鸦云开发平台。

2. 单击左侧导航栏上的 云开发，选择 云开发 > 创建云项目。

   

3. 根据提示，填写云项目信息后，单击 创建。

   对于自定义开发项目，在 开发方式 字段，您必须选择 自定义开发。

   

4. 进入快速配置引导界面，单击 开通授权，进入到资产和用户快速创建引导页面。

   

   平台根据云项目的开发方式，默认为项目选择部分云服务 API。开发者可以在快速配置过程中根据业务需求进行增减，或者选择其他的云服务 API。有关云服务的更多操作详情，请参考 管理 API 服务。

5. 根据提示信息，填写资产和用户信息，然后单击 创建。系统会根据填写的信息快速创建资产和用户，并将资产授权该用户。

   

   您也可以选择跳过此步，在云项目创建完成后，再创建资产和用户。更多资产管理详情，请参考 管理资产。

6. 完成创建后，您可以在云项目列表中查看云项目。

   

   有关云项目的更多操作详情，请参考 项目管理。

添加设备

1. 在云项目列表中，单击进入云项目。

2. 单击 资产 > 添加设备，选择 智慧行业 App 添加设备。

3. 扫描二维码，下载和安装智慧行业 App ，配网添加设备到资产下。

   

   添加结果如下：

   

   如果您没有真实设备，您可以添加虚拟设备。更多虚拟设备详情，请参考 管理虚拟设备。

开通消息订阅

您可以在 云开发 > 消息订阅 中，为云项目开通消息订阅服务，并配置消息订阅参数，获得消息堆积的报警。

开通结果如下：

开发&调试

API 调用

1. 调用 获取设备列表 API，获取资产下设备列表。

   

   可以看到，当前资产下有一个 ID 为 87707085bcddc******3 的设备，该设备是一个插座。

2. 调用 获取设备支持的指令集 API，查询该设备支持的指令集。

   

   可以看到该插座支持两个功能指令：

   • 开关
   • 开关倒计时
   此插座开关指令 code 为 switch_1，value 为 Boolean 类型。true：打开，false：关闭。想了解更多功能指令，请参考 标准指令集。

3. 调用 下发指令 API，控制设备，将插座开关打开。

   

可以看到设备指令下发成功。

消息订阅

1. 在 消息测试 页签中，把设备添加到消息测试通道，并且打开 测试通道。

   

2. 再次调用 下发指令 API，并观察测试通道。

   

   可以看到，我们监听到了关闭插座开关的消息。

   消息测试通道仅供体验和调试使用。如果您将设备添加到测试通道，那您在生产环境将无法收到消息。

至此，您完成了自定义开发业务的快速入门。