---
name: "SmartLampAdvancedAbility.getAdvancedBrightnessVas"
mode: "api"
versionRequirements:
  - { name: "", version: "1.15.0" }
title: "getAdvancedBrightnessVas - 获取高级亮度 VAS（Value Added Service）信息。VAS 信息包含关键点数据，用于获取亮度的显示范围、单位等信息。"
summary: "获取高级亮度增值服务信息，包含关键点的显示范围和单位。"
---

## SmartLampAdvancedAbility.getAdvancedBrightnessVas

> [VERSION] v1.15.0+

### 描述

获取高级亮度（千分之一亮度）VAS 信息，包含关键点，用于亮度条显示范围与单位。

### 参数

无


### 返回值

类型: `VasKeypoints['vasInfo']`

千分之一亮度相关 VAS 数组；不支持时可能为 undefined。需网络。

### 引用对象

##### `interface` VasKeypoints

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `bizId` | `string` | 业务 ID |
| `bizType` | `number` | 业务类型 |
| `vasInfo` | `Object[]` | VAS 信息 |

##### `type` VasKeypoints.vasInfo

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `vasCode` | `string` | VAS 代码 |
| `abilityEnabled` | `boolean` | 能力是否启用 |
| `keyPoints` | `Object[]` | 关键点 |

##### `type` VasKeypoints.vasInfo.keyPoints

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `displayValue` | `number` | 显示值 |
| `originalValue` | `number` | 原始值 |
| `unit` | `string` | 单位 |


### 示例代码

#### 示例

```typescript
const vasInfo = await sdm.lampAdv.getAdvancedBrightnessVas();
vasInfo?.forEach(item => console.log(item.vasCode, item.abilityEnabled, item.keyPoints));
```


**注意事项**

1. 该方法使用 `thousandthBright` 能力代码获取千分之一亮度 VAS 信息
2. 如果设备不支持千分之一亮度功能，可能返回空数组或 `null`
3. 该方法会调用云端接口获取 VAS 信息，需要网络连接
4. VAS 信息中的关键点数据可以用于构建亮度滑动条的显示范围