diff --git a/zh-cn/application-dev/reference/apis/js-apis-brightness.md b/zh-cn/application-dev/reference/apis/js-apis-brightness.md
index 17676f2c3a129536fcce34ca4e5cb418676d736a..9d231f7b337209a7e037f75ca374487e0cdb6a75 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-brightness.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-brightness.md
@@ -1,35 +1,200 @@
# 屏幕亮度
->  **说明：**
-> 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
-
-该模块提供屏幕亮度的设置接口。
+> **说明：**
+> - 从API Version 9 开始，该接口不再维护，推荐使用新接口[`@ohos.brightness`](js-apis-brightness.md)。
+>
+> - 本模块首批接口从API version 3开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
## 导入模块
+
```js
-import brightness from '@ohos.brightness';
+import brightness from '@system.brightness';
```
+
+## brightness.getValue
+
+getValue(Object): void
+
+获得设备当前的屏幕亮度值。
+
+**系统能力：** SystemCapability.PowerManager.DisplayPowerManager
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| success | (data: [BrightnessResponse](#brightnessresponse)) => void | 否 | 接口调用成功的回调函数。 |
+| fail | (data: string, code: number) => void | 否 | 接口调用失败的回调函数。 |
+| complete | () => void | 否 | 接口调用结束的回调函数。 |
+
+
+**示例：**
+
+ ```js
+ export default {
+ getValue() {
+ brightness.getValue({
+ success: function(data){
+ console.log('success get brightness value:' + data.value);
+ },
+ fail: function(data, code) {
+ console.log('get brightness fail, code: ' + code + ', data: ' + data);
+ },
+ });
+ },
+ }
+ ```
+
+
## brightness.setValue
-setValue(value: number): void
+setValue(Object): void
+
+设置设备当前的屏幕亮度值。
+
+**系统能力：** SystemCapability.PowerManager.DisplayPowerManager
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| mode | number | 是 | 屏幕亮度，值为1-255之间的整数。
- 如果值小于等于0，系统按1处理。
- 如果值大于255，系统按255处理。
- 如果值为小数，系统将处理为整数。例如设置为8.1，系统按8处理。 |
+| success | () => void | 否 | 接口调用成功的回调函数。 |
+| fail | (data: string, code: number) => void | 否 | 接口调用失败的回调函数。 |
+| complete | () => void | 否 | 接口调用结束的回调函数。 |
+
+**示例：**
+
+ ```js
+ export default {
+ setValue() {
+ brightness.setValue({
+ value: 100,
+ success: function(){
+ console.log('handling set brightness success.');
+ },
+ fail: function(data, code){
+ console.log('handling set brightness value fail, code:' + code + ', data: ' + data);
+ },
+ });
+ },
+ }
+ ```
-设置系统的屏幕亮度。
-此接口为系统接口，三方应用不支持调用。
+## brightness.getMode
+
+getMode(Object): void
+
+获得当前屏幕亮度模式。
**系统能力：** SystemCapability.PowerManager.DisplayPowerManager
**参数：**
-| 参数名 | 类型 | 必填 | 说明 |
-| ----- | ------ | ---- | ----------- |
-| value | number | 是 | 亮度的值（0~255） |
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| success | (data: [BrightnessResponse](#brightnessresponse)) => void | 否 | 接口调用成功的回调函数。 |
+| fail | (data: string, code: number) => void | 否 | 接口调用失败的回调函数。 |
+| complete | () => void | 否 | 接口调用结束的回调函数。 |
**示例：**
-```js
-brightness.setValue(128);
-```
+ ```js
+ export default {
+ getMode() {
+ brightness.getMode({
+ success: function(data){
+ console.log('success get mode:' + data.mode);
+ },
+ fail: function(data, code){
+ console.log('handling get mode fail, code:' + code + ', data: ' + data);
+ },
+ });
+ },
+ }
+ ```
+
+
+## brightness.setMode
+
+setMode(Object): void
+
+设置设备当前的屏幕亮度模式。
+
+**系统能力：** SystemCapability.PowerManager.DisplayPowerManager
+
+**参数：**
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| mode | number | 是 | 值为0或1
- 0为手动调节屏幕亮度
- 1为自动调节屏幕亮度 |
+| success | () => void | 否 | 接口调用成功的回调函数。 |
+| fail | (data: string, code: number) => void | 否 | 接口调用失败的回调函数。 |
+| complete | () => void | 否 | 接口调用结束的回调函数。 |
+
+**示例：**
+
+ ```js
+ export default {
+ setMode() {
+ brightness.setMode({
+ mode: 1,
+ success: function(){
+ console.log('handling set mode success.');
+ },
+ fail: function(data, code){
+ console.log('handling set mode fail, code:' + code + ', data: ' + data);
+ },
+ });
+ },
+ }
+ ```
+
+
+## brightness.setKeepScreenOn
+
+setKeepScreenOn(Object): void
+
+设置屏幕是否保持常亮状态，开启常亮模式推荐在onShow()阶段调用。
+
+**系统能力：** SystemCapability.PowerManager.DisplayPowerManager
+
+**参数：**
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| keepScreenOn | boolean | 是 | 是否保持屏幕常亮。 |
+| success | () => void | 否 | 接口调用成功的回调函数。 |
+| fail | (data: string, code: number) => void | 否 | 接口调用失败的回调函数。 |
+| complete | () => void | 否 | 接口调用结束的回调函数。 |
+
+**示例：**
+
+ ```js
+ export default {
+ setKeepScreenOn() {
+ brightness.setKeepScreenOn({
+ keepScreenOn: true,
+ success: function () {
+ console.log('handling set keep screen on success.')
+ },
+ fail: function (data, code) {
+ console.log('handling set keep screen on fail, code:' + code + ', data: ' + data);
+ },
+ });
+ },
+ }
+ ```
+##
+
+## BrightnessResponse
+
+屏幕亮度。
+
+| 名称 | 类型 | 说明 |
+| -------- | -------- | -------- |
+| value | number | 屏幕亮度，取值为1-255之间的整数。 |
+
+