全屋智能快速入门

更新时间:2023-06-29 05:58:41下载pdf

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

流程概述

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

创建和配置云项目
关联 OEM App 
开通消息订阅
开发与调试

其中,开发与调试 阶段交互逻辑如下所示:

您的业务涂鸦云端设备获取调用 API 所需的令牌获取 OEM App 用户列表获取某位用户的设备列表查询设备列表里某个设备支持的功能指令向该设备下发指令执行指令通过消息订阅,监听指令产生的消息接收消息您的业务涂鸦云端设备

如果您同时集成了 智能生活 App SDK,也可进行相同开发,在关联自有 App 中选择相对应创建的 App SDK 即可。

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

第一步:创建和配置云项目

云项目是涂鸦 IoT 开发平台设备、用户等开放数据的载体或集合。不同云项目之间的资源相互隔离。有关云项目的更多操作详情,请参考 项目管理

  1. 登录 涂鸦 IoT 开发平台。如果您还未注册开发者账号,可页面提示注册后再登录。

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

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

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

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

    全屋智能快速入门

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

第二步:关联业务数据

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

如果您还没有 OEM App,您可以关联涂鸦 App 账号。

  1. 进入上一步创建的云项目详情页。

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

    全屋智能快速入门
  3. 选择您要关联的 OEM App,即可将 OEM App 关联到云项目。

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

第三步:开通消息订阅

  1. 云开发 > 消息订阅 中,为云项目开通消息订阅服务,并配置消息订阅参数,获得消息堆积的报警。更多消息订阅详情,请参考 管理消息订阅

    全屋智能快速入门
  2. 消息订阅开通后,您还可以自定义配置消息过滤规则,只保留您有需要的消息推送到服务器。

    此功能仅支持 2023 年 6 月 20 日之后创建的项目,历史项目开通消息订阅自动开启默认的消息 bizcode。针对历史项目,如果您需要支持自定义消息规则配置,请 提交工单 联系涂鸦。

    全屋智能快速入门

第四步:开发与调试

调用 API

本小节使用涂鸦 API Explorer 作为 API 调用工具。

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

    全屋智能快速入门

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

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

    全屋智能快速入门

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

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

  3. 选择 IoT Core 服务 > 设备控制(标准指令集)。调用 获取设备支持的指令集 API,查询该设备支持的指令集。

    全屋智能快速入门

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

    • 开关

    • 开关倒计时

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

  4. 调用 下发指令 API,开启插座。

    全屋智能快速入门

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

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

订阅消息

  1. 消息测试 区域,把设备添加到消息测试通道,并且打开 测试通道

    全屋智能快速入门
  2. 再次调用 下发指令 API,并观察测试通道。

    全屋智能快速入门

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

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

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