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以下错误码的详细介绍请参见[屏幕亮度错误码](errorcode-brightness.md)。
36
37| 错误码ID   | 错误信息    |
38|---------|---------|
39| 4700101 | Failed to connect to the service. |
40| 401     | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types. |
41| 202     | Permission verification failed. A non-system application calls a system API.  |
42
43**示例：**
44
45```js
46try {
47    brightness.setValue(128);
48} catch(err) {
49    console.error('set brightness failed, err: ' + err);
50}
51```
52
53## brightness.setValue<sup>11+</sup>
54
55setValue(value: number, continuous: boolean): void
56
57设置系统的屏幕亮度。用于连续调节亮度的场景，在连续调节亮度过程中，设置continuous为true，结束时设置continuous为false，会有更好的性能。
58
59**系统接口：** 此接口为系统接口。
60
61**系统能力：** SystemCapability.PowerManager.DisplayPowerManager
62
63**参数：**
64
65| 参数名 | 类型   | 必填 | 说明                    |
66| ------ | ------ | ---- | ----------------------- |
67| value  | number | 是   | 亮度的值。范围：0~255；该参数必须为数字类型。 |
68| continuous  | boolean | 是   | 亮度调节是否连续；该参数必须为布尔类型。 |
69
70**错误码：**
71
72以下错误码的详细介绍请参见[屏幕亮度错误码](errorcode-brightness.md)。
73
74| 错误码ID   | 错误信息    |
75|---------|---------|
76| 4700101 | Failed to connect to the service. |
77| 401     | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types. |
78| 202     | Permission verification failed. A non-system application calls a system API.  |
79
80**示例：**
81
82```js
83try {
84    brightness.setValue(128, true);
85} catch(err) {
86    console.error('set brightness failed, err: ' + err);
87}
88```