全屋智能快速入门

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

流程概述

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

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

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

创建和配置云项目

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

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

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

   

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

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

   

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

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

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

关联业务数据

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

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

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

   

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

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

   关联结果如下：

   

开通消息订阅

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

开通结果如下：

开发与调试

API 调用

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

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，并观察测试通道。

   

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

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

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