使用
单设备支持群组支持
Info
照明色温/千分之一亮度高级能力 SDK 针对以下场景做了标准化抽象：
- 获取高级能力是否开启
- 转换色温值及单位
- 转换亮度值及单位
- 获取 VAS 关键点信息
起步
SmartLampAdvancedAbility 自 @ray-js/panel-sdk@1.15.0 开始加入。
SmartLampAdvancedAbility(props: SmartLampAdvancedAbilityOptions)
版本要求:
≥1.15.0
描述
照明高级能力，提供色温/亮度的高级转换与 VAS 信息查询
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 是 | 照明高级能力初始化配置 |
返回值
类型：SmartLampAdvancedAbility
SmartLampAdvancedAbility 实例
方法
| 方法名 | 说明 |
|---|---|
| convertTemperature | 转换色温值：若设备启用高级色温能力则返回带单位的显示值（如 2700K），否则返回原始值与空单位。 |
| convertBrightness | 转换亮度值：若设备启用千分之一亮度能力则返回带单位的显示值，否则返回原始值与空单位。 |
| getAdvancedTemperatureVas | 获取高级色温 VAS（增值服务）信息，包含关键点（显示值、原始值、单位），用于色温条范围与展示。 |
| getAdvancedBrightnessVas | 获取高级亮度（千分之一亮度）VAS 信息，包含关键点，用于亮度条显示范围与单位。 |
| getAdvanceHighEnabled | 查询指定 DP 的高级能力是否启用：支持 bright_value（千分之一亮度）、temp_value（标准色温）、color_temp_control（Matter 色温）。 |
| convertDp | 按功能点将原始 DP 值转为带单位的显示值；支持 bright_value、temp_value、color_temp_control。 |