getMatterRoad(schemaObj: Record<string, DpSchema>, force?: boolean)

版本要求:
≥1.15.0

描述

根据 DP schema 推断 Matter 照明设备路数。

参数

参数类型必填说明
schemaObjRecord<string, DpSchema>是dpSchema 对象
forceboolean否未接入 matter-kit 时判断 4 路需传入 true，以读取 brightness_control 上的 hasBrightValueCode

返回值

类型：number
路数：1 仅亮度；2 亮度+色温；3 色相饱和度+亮度；4 色相饱和度+亮度+亮度值；5 色相饱和度+亮度+色温；0 无法识别；异常时可能回退为 5

引用对象

interfaceDpSchema
属性类型必填描述
attrnumber否功能点属性标位，用于扩展功能点的附加能力标识
canTriggerboolean否是否可作为自动化触发条件
codestring是功能点标识码，如 switch
defaultRecommendboolean否是否为默认推荐的功能点
editPermissionboolean否是否具有编辑权限
executableboolean否是否可执行下发
extContentstring否功能点扩展内容，通常为 JSON 字符串
iconnamestring否功能点图标名称
idstring | number是功能点 ID
mode"rw" | "ro" | "wr"是功能点模式类型
rw: 可下发可上报（可读可写）
ro: 只可上报（仅可读）
wr: 只可下发（仅可写）
namestring是功能点名称，一般用于语音等场景
否功能点属性
type"raw" | "obj"是功能点数据类型大类：raw 为原始字节流，obj 为结构化对象

示例代码

示例

import { createMatterKit, useDpSchema } from '@ray-js/panel-sdk';

const matterKit = createMatterKit();
const dpSchema = useDpSchema();
const road = matterKit.utils.getMatterRoad(dpSchema);