diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-brightness.md b/zh-cn/application-dev/reference/apis/js-apis-system-brightness.md
index 9d231f7b337209a7e037f75ca374487e0cdb6a75..cf8e51aa4d1b60ca58443507a460b53ae55387bc 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-system-brightness.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-system-brightness.md
@@ -1,7 +1,7 @@
# 屏幕亮度
> **说明:**
-> - 从API Version 9 开始,该接口不再维护,推荐使用新接口[`@ohos.brightness`](js-apis-brightness.md)。
+> - 从API Version 7 开始,该接口不再维护,推荐使用新接口[`@ohos.brightness`](js-apis-brightness.md)。
>
> - 本模块首批接口从API version 3开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
@@ -30,6 +30,12 @@ getValue(Object): void
| fail | (data: string, code: number) => void | 否 | 接口调用失败的回调函数。 |
| complete | () => void | 否 | 接口调用结束的回调函数。 |
+success返回值:
+
+| 参数名 | 类型 | 说明 |
+| -------- | -------- | -------- |
+| value | number | 屏幕亮度,取值为1-255之间的整数。 |
+
**示例:**
@@ -61,7 +67,7 @@ setValue(Object): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| mode | number | 是 | 屏幕亮度,值为1-255之间的整数。
- 如果值小于等于0,系统按1处理。
- 如果值大于255,系统按255处理。
- 如果值为小数,系统将处理为整数。例如设置为8.1,系统按8处理。 |
+| value | number | 是 | 屏幕亮度,值为1-255之间的整数。
- 如果值小于等于0,系统按1处理。
- 如果值大于255,系统按255处理。
- 如果值为小数,系统将处理为整数。例如设置为8.1,系统按8处理。 |
| success | () => void | 否 | 接口调用成功的回调函数。 |
| fail | (data: string, code: number) => void | 否 | 接口调用失败的回调函数。 |
| complete | () => void | 否 | 接口调用结束的回调函数。 |
@@ -97,10 +103,16 @@ getMode(Object): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| success | (data: [BrightnessResponse](#brightnessresponse)) => void | 否 | 接口调用成功的回调函数。 |
+| success | (data: [BrightnessModeResponse](#brightnessmoderesponse)) => void | 否 | 接口调用成功的回调函数。 |
| fail | (data: string, code: number) => void | 否 | 接口调用失败的回调函数。 |
| complete | () => void | 否 | 接口调用结束的回调函数。 |
+success返回值:
+
+| 参数名 | 类型 | 说明 |
+| -------- | -------- | -------- |
+| mode | number | 值为0或1:
- 0为手动调节屏幕亮度模式
- 1为自动调节屏幕亮度模式 |
+
**示例:**
```js
@@ -130,7 +142,7 @@ setMode(Object): void
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
-| mode | number | 是 | 值为0或1
- 0为手动调节屏幕亮度
- 1为自动调节屏幕亮度 |
+| mode | number | 是 | 值为0或1
- 0为手动调节屏幕亮度。
- 1为自动调节屏幕亮度。 |
| success | () => void | 否 | 接口调用成功的回调函数。 |
| fail | (data: string, code: number) => void | 否 | 接口调用失败的回调函数。 |
| complete | () => void | 否 | 接口调用结束的回调函数。 |
@@ -191,10 +203,13 @@ setKeepScreenOn(Object): void
## BrightnessResponse
-屏幕亮度。
-
| 名称 | 类型 | 说明 |
| -------- | -------- | -------- |
| value | number | 屏幕亮度,取值为1-255之间的整数。 |
+## BrightnessModeResponse
+
+| 名称 | 类型 | 说明 |
+| -------- | -------- | -------- |
+| mode | number | 值为0或1。
-0为手动调节屏幕亮度模式。
-1为手动调节屏幕亮度模式。 |