---
name: "SmartLampAdvancedAbility.convertBrightness"
mode: "api"
versionRequirements:
  - { name: "", version: "1.15.0" }
title: "convertBrightness - 转换亮度值。如果设备启用了千分之一亮度能力，会将亮度值转换为带单位的显示值，否则返回原始值。"
summary: "转换亮度值，若设备启用千分之一亮度能力则返回带单位的显示值。"
---

## SmartLampAdvancedAbility.convertBrightness

> [VERSION] v1.15.0+

### 描述

转换亮度值：若设备启用千分之一亮度能力则返回带单位的显示值，否则返回原始值与空单位。

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `brightness` | `number` | 是 | 亮度原始值（常见范围如 10～1000） |

### 返回值

类型: `ConvertValue`

转换后的数值与单位；未启用高级能力时 unit 为空字符串。依赖云端接口，需网络。

**`type` ConvertValue**

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `value` | `number` | 数值 |
| `unit` | `string` | 单位 |

### 引用对象

##### `type` ConvertValue

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `value` | `number` | 数值 |
| `unit` | `string` | 单位 |


### 示例代码

#### 示例

```typescript
const result = await sdm.lampAdv.convertBrightness(100);
console.log('亮度:', result.value, result.unit);
```


**注意事项**

1. 该方法会自动检测设备是否启用了千分之一亮度能力
2. 如果未启用高级能力，会直接返回原始值和空单位
3. 转换过程会调用云端接口，需要网络连接
4. 亮度值的范围通常是 10-1000（千分之一亮度）