1# @ohos.brightness (屏幕亮度) 2 3该模块提供屏幕亮度的设置接口。 4 5> **说明：** 6> 7> - 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 8> 9> - 本模块接口为系统接口。 10 11## 导入模块 12 13```js 14import brightness from '@ohos.brightness'; 15``` 16 17## brightness.setValue 18 19setValue(value: number): void 20 21设置系统的屏幕亮度。 22 23**系统接口：** 此接口为系统接口。 24 25**系统能力：** SystemCapability.PowerManager.DisplayPowerManager 26 27**参数：** 28 29| 参数名 | 类型 | 必填 | 说明 | 30| ------ | ------ | ---- | ----------------------- | 31| value | number | 是 | 亮度的值。范围：0~255。 | 32 33**错误码：** 34 35以下错误码的详细介绍请参见[屏幕亮度错误码](../errorcodes/errorcode-brightness.md)。 36 37| 错误码ID | 错误信息 | 38|---------|---------| 39| 4700101 | If connecting to the service failed. | 40 41**示例：** 42 43```js 44try { 45 brightness.setValue(128); 46} catch(err) { 47 console.error('set brightness failed, err: ' + err); 48} 49``` 50