文档中心

面板 SDK 概述

更新时间:2020-10-16 01:40:24下载pdf

本文介绍使用面板 SDK 开发时您需要了解的相关概念和技术原理。

什么是面板?

控制面板指的是一类运行在涂鸦智能 App、OEM App 或基于涂鸦 App SDK 开发的 App 上的用于控制 Powered by Tuya智能产品的界面程序。其基于 React Native 框架实现,不仅支持动态更新,同时最大程度的保留了原生 App 的流畅体验。

什么是面板 SDK?

在面板容器里,可以调用 App 模块的一些方法以及面板内封装的工具类方法,统称为面板 SDK。您可以完全自由地开发样式和功能,自由度最高,适合有前端基础的开发者。

面板示例

面板 SDK 概述

相关概念

本章节讲解面板 SDK 开发中常关联的相关概念,更多详情,请参考 名词解释

  • 虚拟设备:指模拟的设备,在有限的模拟范围内能够帮助您快速开发。

    注意:虚拟设备不会主动上报 DP 以及处理联动的逻辑。例如一个插座产品,假设它有一个总开关以及两个子开关的 DP,当您下发了 总开关开启 的指令后,虚拟设备只会上报 总开关开启,而真实设备通过固件的处理后它会上报回总开关以及两个子开关开启。

  • 真实设备:集成了云模组,并且完成了固件逻辑处理的设备。

  • DP(Data Point):常被称为功能点,是智能产品开发中的最重要的环节,用于描述产品功能及其参数。在定义好产品 DP 后,您就可以根据 DP 的类型进行产品开发了。

    • DP ID:功能点的编码,后续设备与云端的功能数据传输通过功能点 ID 进行。

    • DP 数据类型:

      数据类型 英文名称 说明 示例
      布尔型 bool 非真即假的二值型变量 开关功能,开/关
      数值型 value 适用于可线性调节类型的数据 温度调节,温度范围 20-40℃
      枚举型 enum 自定义的有限集合值 工作档位,低档、中档、高档
      Bitmap 型 bitmap 用于多状态的显示,一般是专门用于上报和统计故障的功能点。 暂无
      字符串型 string 以字符串形式传输的功能点,一般用于较复杂功能,只有当其他类型无法满足时多方协同好进行使用。 暂无
      透传型 raw raw 型简单来说就是经过 Base64 加密过后的 string 型,在控制面板端,数据下发的流程只需要与 string 保持一致即可,native 端会帮您进行 Base64 编码及解码。 智能锁密码的管理,例如创建和删除密码
    • DP 传输类型:

      传输类型 说明
      可下发可上报 数据可以下发给设备,设备数据可以上报给云端
      只上报 数据只支持从设备上报
      只下发 数据只支持从云端下发
点击获取服务和帮助