---
title: 功能点解析集（protocols）- 标准化设备 DP 功能点协议解析类集合
summary: "@ray-js/panel-sdk 提供的功能点解析集（protocols），包含一系列标准化的设备 DP 功能点协议解析类，用于简化面板开发中的功能点数据解析和转换。通过 import { protocols } from '@ray-js/panel-sdk' 导入，具体的导出项和用法可参考垂直品类下的\"能力集\"或\"模块集\"文档。可与 SDM 的 dp-kit 拦截器搭配使用，配置到 createDpKit 的 protocols 参数中实现自动解析/反解析复杂类型 DP。"
questions:
  - 如何通过 import { protocols } from '@ray-js/panel-sdk' 导入功能点解析集？
  - protocols 中的标准化协议解析类解决了面板开发中什么问题（复杂 DP 数据的解析和转换）？
  - 'protocols 的具体导出项和用法文档在哪里查阅（垂直品类下的"能力集"或"模块集"）？'
  - 功能点解析集如何与 SDM 的 dp-kit createDpKit 的 protocols 参数搭配使用？
  - protocols 中的解析类是否包含颜色（ColourTransformer）、温度等特定类型的协议解析？
  - 功能点解析集与 useStructuredProps/useStructuredActions 是什么关系？
  - 使用 protocols 前需要先安装 @ray-js/panel-sdk 吗，最低版本要求是什么？
  - protocols 中的解析类是否支持自定义 parser/formatter 扩展？
  - 不同品类设备（照明、传感器等）的 protocols 解析类有什么区别？
  - protocols 功能点解析集在不使用 SDM 模式时能否独立使用？
---

# 功能点解析集

功能点解析集（protocols）指的是一系列在您开发控制设备面板业务的时候需要用到的一些标准化的设备功能点协议解析类，我们在 @ray-js/panel-sdk 中做了一层包装，帮助您更方便的开发智能产品。

<Image src='/images/panel/panel-protocols.png'/>

## 安装

```shell
$ yarn add @ray-js/panel-sdk
```

## 使用

```javascript
import { protocols } from '@ray-js/panel-sdk';

// 具体的导出项和用法可参考垂直品类下的"能力集"或"模块集"
const { xxx } = protocols;
```