云云接入

本文介绍如何采用云云接入方式，完成生态设备接入（TuyaLink）产品开发。

概念说明

云云接入

云云接入是 涂鸦开发者平台 面向各领域行业生态云提供的对接方式，支持三方业务系统通过 OpenAPI 的方式，将成熟的设备生态融入涂鸦生态。设备无需改造，即可通过平台标准化的集成服务，完成多业务系统设备融合，低成本地实现跨行业跨领域设备之间的互通互联。接入完成后，设备可以直接在涂鸦生态的 App 和 SaaS 中使用。

核心流程

开发者主要通过创建云开发项目，获取项目授权密钥，集成云云接入服务和消息订阅服务相关的OpenAPI，通过三方生态业务系统模拟设备进行数据上报和接收，完成设备全生命周期的管理。

操作说明

第一步：创建产品

在创建产品过程中，选择智能化方式时，单击生态设备接入。具体创建详情，可查看创建产品。

第二步：功能定义

根据产品特性进行相关功能点定义。具体详情，可查看功能定义。

第三步：设备开发

根据需求情况，在设备开发页面按照步骤流程进行操作。

1. 在选择接入方式时，单击云云接入。查看接入指南，可查看完整的文档介绍。

   

2. 开通服务。

   平台提供了设备云云接入服务用于云云对接，需前往开通，并根据引导，授权到对应的云开发项目。

   

   下图展示了一部分云云接入 API 列表。具体详情，可查看 设备云云接入服务。请确保已开通云云接入和完成项目授权。

   

   

   云云接入服务仅提供设备南向接入能力（即设备上报消息）。若需要接收云端消息下发，需要完成应用开发，见下文介绍。

   授权产品到项目

   完成服务开通和项目授权后，您需要将当前产品授权给对应项目。授权成功后，产品设备数据才能通过对应项目的授权密钥身份进行 API 调用和对应产品设备数据的传输。单个产品最多支持添加 2 个项目。

   

   项目必须在已授权云云接入服务，同时授权给产品后，该产品数据才能通过云云接入对应 API 进行数据传递。

   开通并获取消息订阅 SDK

   云云接入时，作为三方生态业务系统需要接收来自云端的消息推送，才能接受涂鸦云体系的 App 或 SaaS 的控制指令，主要通过集成消息订阅 SDK，订阅属性设置和动作执行的 BizCode。

   • 属性设置：setThingProperties
   • 动作执行：execThingAction

   默认开通消息订阅即可。具体详情，可查看消息订阅。

   

   云云接入服务 API 集成开发

   完成配置步骤后，在项目概况页面，获取授权密钥，进行云云接入 API 的集成和开发。

   

3. 调试验证。

   流程 1：验证设备上报

   集成 API 前，您可以使用云云接入服务 API 调试工具，模拟设备注册、设备上线以及设备上报。具体操作如下：

   第一步：进入云云接入服务详情页面，单击调试，选择已授权的项目，进入调试页面。

   

   第二步：进行设备注册前，需要先购买设备接入授权码，并分配到对应产品。具体管理详情，可查看 授权码管理。
   

   设备注册，根据 API 定义，填写注册需要的参数，完成设备注册。
   

   注册成功，将获得涂鸦的设备 ID，用于后续设备上线、设备上报等相关 API 调用。
   

   第三步：注册完成后，进行设备上线操作。
   

   第四步：进行设备属性上报。为了方便查看设备上报是否成功，您可通过设备在线调试功能或采用App 面板进行数据通信验证。

   打开在线调试，可以用于进行设备控制下发和获取当前设备数据操作。具体可查看 操作说明。
   

   前提条件：设备必须正常注册，且处于在线状态。具体详情，可查看 在线调试。

   进行设备属性上报 API 调用操作，当前设置 weight 为 20，单击发起调用。
   

   调用成功后，进入在线调试页面，获取最新设备属性数据，并可看到上报日志。
   

   流程二：验证三方云接收涂鸦下发数据消息

   三方云接收涂鸦下发消息主要通过集成消息订阅服务 SDK。具体集成方式，可查看 消息队列。为了方便调试验证，可分别使用消息订阅测试功能和设备在线调试功能完成功能验证。

   第一步：开通消息订阅，进入调试页面，添加用于测试的设备。添加成功后，若云端有下发消息，可在日志中获得下发数据。
   

   第二步：打开在线调试工具，模拟云端下发设置设备属性的指令，如图所示。设置通道切换为 wifi，可以看到下行消息日志。
   

   第三步：进入消息订阅中，可查看云端下发属性设置消息内容。
   

   至此，通过云云接入方式进行设备接入已完成基本的在线调试链路验证。真实使用时，需要三方云业务系统，根据实际情况分别集成云云接入服务和消息订阅服务，完成设备数据流转，实现云云对接。

4. 接入使用。

   完成云云接入设备正常调试后，则可进行产品发布。发布完成后，若需要进一步进行应用开发，将接入设备应用到相关业务系统中，则可访问 应用开发。

   

注意事项

由于进行云云接入的三方业务系统里，设备是否真实可控需要由三方业务系统保证，内部需要根据接入涂鸦 IoT 云后做相关的功能更新。因此产品发布后，请保证链路稳定运行，满足设备可用性，避免收到客户反馈，影响客户使用。

后续操作

更多接入方式，可查看 生态设备接入。