面板 SDK(RN 面板)

更新时间:2023-10-12 08:00:13下载pdf

本文介绍面板 SDK 开发的相关概念和技术原理。

什么是面板?

面板(控制面板)是用于控制智能产品的界面程序。面板基于 React Native(RN)框架实现,不仅支持动态更新,同时最大程度的保留原生 App 的流畅体验。

面板 SDK(RN 面板)

涂鸦面板可运行于以下环境:

什么是面板 SDK?

涂鸦面板 SDK 是面板容器为开发者提供的一系列辅助控制面板开发的工具集合。您可以基于面板 SDK 完全自由的在面板容器内开发样式和功能,实现对智能设备、定时任务、场景的管理。

面板 SDK 支持的能力集

面板 SDK(RN 面板)

面板 SDK 包含的能力

面板 SDK 能力 说明
TYSdk 封装了获取智能设备信息、控制设备、云端服务、App 原生模块的能力,加速 IoT 应用的开发过程。
面板 UI 组件包 提供了一系列丰富的 RN 基础组件,加速 IoT 应用的开发过程。
脚手架 提供了一系列基础及业务品类的模板代码供您参考和使用,加速 IoT 应用的开发过程。
品类 SDK 提供了一系列基于 TYSdk 和面板 UI 组件包的业务品类 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 传输类型:

      传输类型 说明
      可下发可上报 数据可以下发给设备,设备数据可以上报给云端
      只上报 数据只支持从设备上报
      只下发 数据只支持从云端下发