自定义开发快速入门

更新时间:2024-06-19 03:19:16下载pdf

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

示例

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

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

交互逻辑如下所示:

自定义开发快速入门

成为开发者

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

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

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

创建和配置云项目

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

  1. 登录 涂鸦云开发平台

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

    自定义开发快速入门

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

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

    自定义开发快速入门

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

    自定义开发快速入门

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

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

    自定义开发快速入门

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

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

    自定义开发快速入门

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

添加设备

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

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

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

    自定义开发快速入门

    添加结果如下:

    自定义开发快速入门

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

开通消息订阅

您可以在 云开发 > 消息订阅 中,为云项目开通消息订阅服务,并配置消息订阅参数,获得消息堆积的报警。
自定义开发快速入门

开通结果如下:

自定义开发快速入门

更多消息订阅详情,请参考 管理消息订阅

开发&调试

API 调用

我们将使用 API Explorer,完成上述案例。

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

    自定义开发快速入门

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

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

    自定义开发快速入门

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

    • 开关
    • 开关倒计时

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

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

    自定义开发快速入门

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

消息订阅

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

    自定义开发快速入门

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

    自定义开发快速入门

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

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

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