1e41f4b71Sopenharmony_ci# @ohos.brightness (屏幕亮度)(系统接口) 2e41f4b71Sopenharmony_ci 3e41f4b71Sopenharmony_ci该模块提供屏幕亮度的设置接口。 4e41f4b71Sopenharmony_ci 5e41f4b71Sopenharmony_ci> **说明：** 6e41f4b71Sopenharmony_ci> 7e41f4b71Sopenharmony_ci> - 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 8e41f4b71Sopenharmony_ci> 9e41f4b71Sopenharmony_ci> - 本模块接口为系统接口。 10e41f4b71Sopenharmony_ci 11e41f4b71Sopenharmony_ci## 导入模块 12e41f4b71Sopenharmony_ci 13e41f4b71Sopenharmony_ci```js 14e41f4b71Sopenharmony_ciimport brightness from '@ohos.brightness'; 15e41f4b71Sopenharmony_ci``` 16e41f4b71Sopenharmony_ci 17e41f4b71Sopenharmony_ci## brightness.setValue 18e41f4b71Sopenharmony_ci 19e41f4b71Sopenharmony_cisetValue(value: number): void 20e41f4b71Sopenharmony_ci 21e41f4b71Sopenharmony_ci设置系统的屏幕亮度。 22e41f4b71Sopenharmony_ci 23e41f4b71Sopenharmony_ci**系统接口：** 此接口为系统接口。 24e41f4b71Sopenharmony_ci 25e41f4b71Sopenharmony_ci**系统能力：** SystemCapability.PowerManager.DisplayPowerManager 26e41f4b71Sopenharmony_ci 27e41f4b71Sopenharmony_ci**参数：** 28e41f4b71Sopenharmony_ci 29e41f4b71Sopenharmony_ci| 参数名 | 类型 | 必填 | 说明 | 30e41f4b71Sopenharmony_ci| ------ | ------ | ---- | ----------------------- | 31e41f4b71Sopenharmony_ci| value | number | 是 | 亮度的值。范围：0~255；该参数必须为数字类型。 | 32e41f4b71Sopenharmony_ci 33e41f4b71Sopenharmony_ci**错误码：** 34e41f4b71Sopenharmony_ci 35e41f4b71Sopenharmony_ci以下错误码的详细介绍请参见[屏幕亮度错误码](errorcode-brightness.md)。 36e41f4b71Sopenharmony_ci 37e41f4b71Sopenharmony_ci| 错误码ID | 错误信息 | 38e41f4b71Sopenharmony_ci|---------|---------| 39e41f4b71Sopenharmony_ci| 4700101 | Failed to connect to the service. | 40e41f4b71Sopenharmony_ci| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types. | 41e41f4b71Sopenharmony_ci| 202 | Permission verification failed. A non-system application calls a system API. | 42e41f4b71Sopenharmony_ci 43e41f4b71Sopenharmony_ci**示例：** 44e41f4b71Sopenharmony_ci 45e41f4b71Sopenharmony_ci```js 46e41f4b71Sopenharmony_citry { 47e41f4b71Sopenharmony_ci brightness.setValue(128); 48e41f4b71Sopenharmony_ci} catch(err) { 49e41f4b71Sopenharmony_ci console.error('set brightness failed, err: ' + err); 50e41f4b71Sopenharmony_ci} 51e41f4b71Sopenharmony_ci``` 52e41f4b71Sopenharmony_ci 53e41f4b71Sopenharmony_ci## brightness.setValue<sup>11+</sup> 54e41f4b71Sopenharmony_ci 55e41f4b71Sopenharmony_cisetValue(value: number, continuous: boolean): void 56e41f4b71Sopenharmony_ci 57e41f4b71Sopenharmony_ci设置系统的屏幕亮度。用于连续调节亮度的场景，在连续调节亮度过程中，设置continuous为true，结束时设置continuous为false，会有更好的性能。 58e41f4b71Sopenharmony_ci 59e41f4b71Sopenharmony_ci**系统接口：** 此接口为系统接口。 60e41f4b71Sopenharmony_ci 61e41f4b71Sopenharmony_ci**系统能力：** SystemCapability.PowerManager.DisplayPowerManager 62e41f4b71Sopenharmony_ci 63e41f4b71Sopenharmony_ci**参数：** 64e41f4b71Sopenharmony_ci 65e41f4b71Sopenharmony_ci| 参数名 | 类型 | 必填 | 说明 | 66e41f4b71Sopenharmony_ci| ------ | ------ | ---- | ----------------------- | 67e41f4b71Sopenharmony_ci| value | number | 是 | 亮度的值。范围：0~255；该参数必须为数字类型。 | 68e41f4b71Sopenharmony_ci| continuous | boolean | 是 | 亮度调节是否连续；该参数必须为布尔类型。 | 69e41f4b71Sopenharmony_ci 70e41f4b71Sopenharmony_ci**错误码：** 71e41f4b71Sopenharmony_ci 72e41f4b71Sopenharmony_ci以下错误码的详细介绍请参见[屏幕亮度错误码](errorcode-brightness.md)。 73e41f4b71Sopenharmony_ci 74e41f4b71Sopenharmony_ci| 错误码ID | 错误信息 | 75e41f4b71Sopenharmony_ci|---------|---------| 76e41f4b71Sopenharmony_ci| 4700101 | Failed to connect to the service. | 77e41f4b71Sopenharmony_ci| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types. | 78e41f4b71Sopenharmony_ci| 202 | Permission verification failed. A non-system application calls a system API. | 79e41f4b71Sopenharmony_ci 80e41f4b71Sopenharmony_ci**示例：** 81e41f4b71Sopenharmony_ci 82e41f4b71Sopenharmony_ci```js 83e41f4b71Sopenharmony_citry { 84e41f4b71Sopenharmony_ci brightness.setValue(128, true); 85e41f4b71Sopenharmony_ci} catch(err) { 86e41f4b71Sopenharmony_ci console.error('set brightness failed, err: ' + err); 87e41f4b71Sopenharmony_ci} 88e41f4b71Sopenharmony_ci```