简体中文
简体中文
English
联系我们
注册
登录

全屋智能快速入门

更新时间:2022-09-14 06:37:28下载pdf

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

示例

例如,将 OEM App 授权并关联到一个新的云项目,并通过 OpenAPI 和消息队列来查询用户信息和控制设备。

  1. 成为开发者。
  2. 创建和配置云项目。
  3. 关联 OEM App。
  4. 开通消息队列服务。
  5. 开发&调试。
    a. 获取调用 OpenAPI 所需的令牌。
    b. 获取 OEM App 用户列表。
    c. 获取某位用户的设备列表。
    d. 查询设备列表里某个设备支持的功能指令。
    e. 向该设备下发指令。
    f. 通过消息订阅,监听指令产生的消息。

交互逻辑

交互逻辑如下所示:

全屋智能快速入门

下文将分步骤,进行详细介绍。

成为开发者

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

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

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

创建和配置云项目

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

  1. 登录 涂鸦云开发平台

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

    全屋智能快速入门

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

    对于全屋智能项目,在 开发方式 字段,您必须选择 全屋智能

    全屋智能快速入门

  4. 进入快速配置引导界面,单击 开通授权,完成云服务的开通和对云项目的授权。

    全屋智能快速入门

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

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

    全屋智能快速入门

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

关联业务数据

创建云项目后,您需要将您的 OEM App 关联到云项目上。

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

  2. 单击 设备 > 关联自有App > 添加App

    全屋智能快速入门

  3. 选择您要关联的 OEM App,即可将 OEM App 关联到云项目。

关联结果如下:

全屋智能快速入门

如果您还没有 OEM App,您可以关联涂鸦 App 账号。在关联 OEM App 或 涂鸦 App 账号时,会跳出选择设备关联方案和设备权限的弹窗。为了方便您快速入门,设备关联方案请选择 自动关联,设备权限请选择 读、写、管理。了解更多关联详情,请参考 关联设备

开通消息订阅

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

全屋智能快速入门

开通结果如下:

全屋智能快速入门

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

开发&调试

API 调用

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

  1. 调用 获取用户列表 API,获取 App 用户。

    全屋智能快速入门

    可以看到,当前 OEM App 下面有一个 UID 为 ay16600***ONz7 的用户。

  2. 调用 获取用户的设备列表 API,获取用户下的设备。

    全屋智能快速入门

    可以看到,该用户下有一个 ID 为 87707085bcddc****fa3 的设备,该设备是一个插座。

    如果您关联的是涂鸦 App 账号,您可以在关联涂鸦 App 账号列表中找到用户的 UID。

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

    全屋智能快速入门

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

    • 开关
    • 开关倒计时

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

  4. 调用 控制设备 API,控制设备,将插座开关打开。

    全屋智能快速入门

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

    [
        {
            "code":"switch_1",
            "value":true
        }
    ]
    

消息订阅

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

    全屋智能快速入门

  2. 再次调用 控制设备 API,并观察测试通道。

    全屋智能快速入门

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

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

至此,您完成了全屋智能业务的快速入门。