通用品类能力

通用品类能力由 “基础库内置能力” 与 “Panel SDK 开发套件” 两部分组成,旨在通过标准化交互与提炼开发模型,提升面板小程序的开发效率。

能力清单

维度实现主体模块名说明文档
标准核心能力基础库面板环境初始化自动处理离线弹窗、蓝牙连接、OTA 升级、故障提醒等逻辑总览与初始化
连接与离线离线遮罩引导与蓝牙自动重连行为说明连接与离线逻辑
OTA 升级固件检测、强制/提醒升级逻辑OTA 升级说明
面板开发套件Panel SDK智能设备模型 (SDM)基于 OOP 的智能设备编程模型,简化数据管理与控制逻辑智能设备模型
智能群组模型 (SGM)基于 OOP 的智能群组编程模型智能群组模型
多设备管理在同一小程序内自由管理多台独立设备实例,支持批量状态读取与指令下发多设备管理
面板多语言面板专属国际化适配方案,支持云端词条同步多语言配置
功能点解析集常用功能点协议的解析 with 转换工具功能点解析集
Hooks & Utils提炼自业务逻辑的常用 React Hooks 与工具函数Hooks

1. 基础库内置能力

基础库内置能力是涂鸦面板小程序的标准交互规范实现。它由基础库直接驱动,无需安装额外依赖(需引入 DeviceKit),主要解决设备生命周期中的共性交互问题(如:如何提醒用户设备离线、如何引导固件升级等)。

2. Panel SDK 开发套件

Panel SDK 是为了提升开发者编程体验而设计的扩展套件。它通过对设备 DPs、群组、多语言等底层数据的抽象封装,提供了一套更符合现代前端开发习惯(OOP/Hooks)的编程模型。

  • 特点:提效显著、灵活扩展、按需引入。
  • 安装依赖:

安装

$ yarn add @ray-js/panel-sdk
# or
$ npm install @ray-js/panel-sdk

使用

// 引入标准环境初始化(基础库能力)
import { initPanelEnvironment } from '@ray-js/ray';

// 引入 Panel SDK 工具(SDK 能力)
import { useProps, useActions } from '@ray-js/panel-sdk';