!8958 翻译已完成 8662+8549+8433+8359+8125

Merge pull request !8958 from shawn_he/8125-a

en/application-dev/connectivity/socket-connection.md

@@ -74,7 +74,7 @@ The implementation is similar for UDPSocket and TCPSocket. The following uses th
        console.log("on close")
    });
    
-   // Bind the IP address and port number.
+   // Bind the local IP address and port number.
    let bindAddress = {
        address: '192.168.xx.xx',
        port: 1234, // Bound port, for example, 1234.

en/application-dev/device/usb-guidelines.md

@@ -16,11 +16,11 @@ The following table lists the USB APIs currently available. For details, see the
 | ------------------------------------------------------------ | ------------------------------------------------------------ |
 | hasRight(deviceName: string): boolean                        | Checks whether the user, for example, the application or system, has the device access permissions. The value **true** is returned if the user has the device access permissions; the value **false** is returned otherwise. |
 | requestRight(deviceName: string): Promise\<boolean>          | Requests the temporary permission for a given application to access the USB device. |
-| connectDevice(device: USBDevice): Readonly\<USBDevicePipe>   | Connects to the USB device based on the device information returned by **getDevices()**. |
+| connectDevice(device: USBDevice): Readonly\<USBDevicePipe>   | Connects to the USB device based on the device information returned by `getDevices()`. |
 | getDevices(): Array<Readonly\<USBDevice>>                    | Obtains the USB device list.                                 |
 | setConfiguration(pipe: USBDevicePipe, config: USBConfig): number | Sets the USB device configuration.                           |
 | setInterface(pipe: USBDevicePipe, iface: USBInterface): number | Sets a USB interface.                                        |
-| claimInterface(pipe: USBDevicePipe, iface: USBInterface, force?: boolean): number | Claims a USB interface                                       |
+| claimInterface(pipe: USBDevicePipe, iface: USBInterface, force?: boolean): number | Claims a USB interface.                                       |
 | bulkTransfer(pipe: USBDevicePipe, endpoint: USBEndpoint, buffer: Uint8Array, timeout?: number): Promise\<number> | Performs bulk transfer.                                      |
 | closePipe(pipe: USBDevicePipe): number                       | Closes a USB device pipe.                                    |
 | releaseInterface(pipe: USBDevicePipe, iface: USBInterface): number | Releases a USB interface.                                    |
@@ -113,7 +113,7 @@ You can set a USB device as a host to connect to a device for data transfer. The
     Claim the corresponding interface from deviceList.
     interface1 must be one present in the device configuration.
     */
-    usb.claimInterface(pipe , interface1, true);
+    usb.claimInterface(pipe, interface1, true);
     ```
 
 4.  Perform data transfer.

en/application-dev/internationalization/intl-guidelines.md

@@ -3,7 +3,8 @@
 This module provides basic I18N capabilities, such as time and date formatting, number formatting, and string sorting, through the standard I18N interfaces defined in ECMA 402.
 The [I18N](i18n-guidelines.md) module provides enhanced I18N capabilities through supplementary interfaces that are not defined in ECMA 402. It works with the Intl module to provide a complete suite of I18N capabilities.
 
-> **NOTE**<br>
+> **NOTE**
+> 
 > In the code snippets in this document, **intl** refers to the name of the imported module.
 
 ## Setting Locale Information
@@ -24,7 +25,8 @@ Use [Locale](../reference/apis/js-apis-intl.md) APIs to maximize or minimize loc
 
 ### How to Develop
 
-1. Instantiate a **Locale** object.<br>
+1. Instantiate a **Locale** object.
+
    Create a **Locale** object by using the **Locale** constructor. This method receives a string representing the locale and an optional [Attributes](../reference/apis/js-apis-intl.md) list. 
 
    A **Locale** object consists of four parts: language, script, region, and extension, which are separated by using a hyphen (-).
@@ -42,30 +44,33 @@ Use [Locale](../reference/apis/js-apis-intl.md) APIs to maximize or minimize loc
       | kf | Whether upper case or lower case is considered when sorting or comparing strings.|
 
    
-   ```
+   ```js
    var locale = "zh-CN";
    var options = {caseFirst: false, calendar: "chinese", collation: pinyin};
    var localeObj = new intl.Locale(locale, options);
    ```
 
-2. Obtain the string representing a **Locale** object.<br>
+2. Obtain the string representing a **Locale** object.
+
    Call the **toString** method to obtain the string representing a **Locale** object, which includes the language, region, and other options.
    
-   ```
+   ```js
    var localeStr = localeObj.toString();
    ```
 
-3. Maximize locale information.<br>
+3. Maximize locale information.
+
    Call the **maximize** method to maximize locale information; that is, supplement the missing script and region information.
    
-   ```
+   ```js
    var maximizedLocale = localeObj.maximize();
    ```
 
-4. Minimize locale information.<br>
+4. Minimize locale information.
+
    Call the **minimize** method to minimize locale information; that is, delete the unnecessary script and region information.
    
-   ```
+   ```js
    var minimizedLocale = localeObj.minimize();
    ```
 
@@ -88,42 +93,46 @@ Use [DateTimeFormat](../reference/apis/js-apis-intl.md) APIs to format the date
 
 ### How to Develop
 
-1. Instantiate a **DateTimeFormat** object.<br>
+1. Instantiate a **DateTimeFormat** object.
+
    Use the default constructor of **DateTimeFormat** to obtain the system default locale by accessing the system language and region settings, and set it as the locale in the **DateTimeFormat** object.
 
    
-   ```
+   ```js
    var dateTimeFormat = new intl.DateTimeFormat();
    ```
 
    Alternatively, use your own locale and formatting parameters to create a **DateTimeFormat** object. Formatting parameters are optional. For a full list of formatting parameters, see [DateTimeOptions](../reference/apis/js-apis-intl.md).
    
-   ```
+   ```js
    var options = {dateStyle: "full", timeStyle: "full"};
    var dateTimeFormat = new intl.DateTimeFormat("zh-CN", options);
    ```
 
-2. Format the date and time.<br>
+2. Format the date and time.
+
    Call the **format** method to format the date and time in the **DateTimeFormat** object. This method returns a string representing the formatting result.
    
-   ```
+   ```js
    Date date = new Date();
    var formatResult = dateTimeFormat.format(date);
    ```
 
-3. Format a period.<br>
+3. Format a period.
+
    Call the **formatRange** method to format the period in the **DateTimeFormat** object. This method requires input of two **Date** objects, which respectively indicate the start date and end date of a period. This method returns a string representing the formatting result.
    
-   ```
+   ```js
    Date startDate = new Date();
    Date endDate = new Date();
    var formatResult = dateTimeFormat.formatRange(startDate, endDate);
    ```
 
-4. Obtain attributes of the **DateTimeFormat** object.<br>
+4. Obtain attributes of the **DateTimeFormat** object.
+
    Call the **resolvedOptions** method to obtain attributes of the **DateTimeFormat** object. This method will return an array that contains all attributes and values of the object.
    
-   ```
+   ```js
    var options = dateTimeFormat.resolvedOptions();
    ```
 
@@ -145,33 +154,36 @@ Use [NumberFormat](../reference/apis/js-apis-intl.md) APIs to format numbers for
 
 ### How to Develop
 
-1. Instantiate a **NumberFormat** object.<br>
+1. Instantiate a **NumberFormat** object.
+
    Use the default constructor of **NumberFormat** to obtain the system default locale by accessing the system language and region settings, and set it as the locale in the **NumberFormat** object.
 
    
-   ```
+   ```js
    var numberFormat = new intl.NumberFormat();
    ```
 
    Alternatively, use your own locale and formatting parameters to create a **NumberFormat** object. Formatting parameters are optional. For a full list of formatting parameters, see [NumberOptions](../reference/apis/js-apis-intl.md).
    
-   ```
+   ```js
    var options = {compactDisplay: "short", notation: "compact"};
    var numberFormat = new intl.NumberFormat("zh-CN", options);
    ```
 
-2. Format a number.<br>
+2. Format a number.
+
    Call the **format** method to format a number. A string is returned as the formatting result.
    
-   ```
+   ```js
    var number = 1234.5678
    var formatResult = numberFormat.format(number);
    ```
 
-3. Obtain attributes of the **NumberFormat** object.<br>
+3. Obtain attributes of the **NumberFormat** object.
+
    Call the **resolvedOptions** method to obtain attributes of the **NumberFormat** object. This method will return an array that contains all attributes and values of the object.
    
-   ```
+   ```js
    var options = numberFormat.resolvedOptions();
    ```
 
@@ -193,33 +205,36 @@ Use [Collator](../reference/apis/js-apis-intl.md) APIs to sort strings based on
 
 ### How to Develop
 
-1. Instantiate a **Collator** object.<br>
+1. Instantiate a **Collator** object.
+
    Use the default constructor of **Collator** to obtain the system default locale by accessing the system language and region settings, and set it as the locale in the **Collator** object.
 
    
-   ```
+   ```js
    var collator = new intl.Collator();
    ```
 
    Alternatively, use your own locale and formatting parameters to create a **Collator** object. For a full list of parameters, see [CollatorOptions](../reference/apis/js-apis-intl.md).
    
+   ```js
+   var collator= new intl.Collator("zh-CN", {localeMatcher: "best fit", usage: "sort"});
    ```
-   var collator= new intl.Collator("zh-CN", {localeMatcher: "best fit", usage: "sort"};
-   ```
 
-2. Compare two strings.<br>
+2. Compare two strings.
+
    Call the **compare** method to compare two input strings. This method returns a value as the comparison result. The return value **-1** indicates that the first string is shorter than the second string, the return value **1** indicates that the first string is longer than the second string, and the return value **0** indicates that the two strings are of equal lengths.
    
-   ```
+   ```js
    var str1 = "first string";
    var str2 = "second string";
    var compareResult = collator.compare(str1, str2);
    ```
 
-3. Obtain attributes of the **Collator** object.<br>
+3. Obtain attributes of the **Collator** object.
+
    Call the **resolvedOptions** method to obtain attributes of the **Collator** object. This method will return an array that contains all attributes and values of the object.
    
-   ```
+   ```js
    var options = collator.resolvedOptions();
    ```
 
@@ -240,24 +255,26 @@ Use [PluralRules](../reference/apis/js-apis-intl.md) APIs to determine the singu
 
 ### How to Develop
 
-1. Instantiate a **PluralRules** object.<br>
+1. Instantiate a **PluralRules** object.
+
    Use the default constructor of **PluralRules** to obtain the system default locale by accessing the system language and region settings, and set it as the locale in the **PluralRules** object.
 
    
-   ```
+   ```js
    var pluralRules = new intl.PluralRules();
    ```
 
    Alternatively, use your own locale and formatting parameters to create a **PluralRules** object. For a full list of parameters, see [PluralRulesOptions](../reference/apis/js-apis-intl.md).
    
-   ```
-   var plurals = new intl.PluralRules("zh-CN", {localeMatcher: "best fit", type: "cardinal"};
+   ```js
+   var plurals = new intl.PluralRules("zh-CN", {localeMatcher: "best fit", type: "cardinal"});
    ```
 
-2. Determine the singular-plural type.<br>
+2. Determine the singular-plural type.
+
    Call the **select** method to determine the singular-plural type of an input number. This method will return a string representing the singular-plural type, which can be any of the following: **zero**, **one**, **two**, **few**, **many**, and **other**.
    
-   ```
+   ```js
    var number = 1234.5678
    var categoryResult = plurals.select(number);
    ```
@@ -281,41 +298,45 @@ Use [RelativeTimeFormat](../reference/apis/js-apis-intl.md) APIs to format the r
 
 ### How to Develop
 
-1. Instantiate a **RelativeTimeFormat** object.<br>
+1. Instantiate a **RelativeTimeFormat** object.
+
    Use the default constructor of **RelativeTimeFormat** to obtain the system default locale by accessing the system language and region settings, and set it as the locale in the **RelativeTimeFormat** object.
 
    
-   ```
+   ```js
    var relativeTimeFormat = new intl.RelativeTimeFormat();
    ```
 
    Alternatively, use your own locale and formatting parameters to create a **RelativeTimeFormat** object. Formatting parameters are optional. For a full list of formatting parameters, see [ RelativeTimeFormatInputOptions](../reference/apis/js-apis-intl.md).
    
+   ```js
+   var relativeTimeFormat = new intl.RelativeTimeFormat("zh-CN", {numeric: "always", style: "long"});
    ```
-   var relativeTimeFormat = new intl.RelativeTimeFormat("zh-CN", {numeric: "always", style: "long"};
-   ```
 
-2. Format the relative time.<br>
+2. Format the relative time.
+
    Call the **format** method to format the relative time. This method receives a numeric value representing the time length and a string-form unit, like **year**, **quarter**, **month**, **week**, **day**, **hour**, **minute**, and **second**. This method returns a string representing the formatting result.
    
-   ```
+   ```js
    var number = 2;
    var unit = "year"
    var formatResult = relativeTimeFormat.format(number, unit);
    ```
 
-3. Obtain each part of the relative time format.<br>
+3. Obtain each part of the relative time format.
+
    Upon obtaining each part of the relative time format, customize the relative time formatting result.
    
-   ```
+   ```js
    var number = 2;
    var unit = "year"
    var formatResult = relativeTimeFormat.formatToParts(number, unit);
    ```
 
-4. Obtain attributes of the **RelativeTimeFormat** object.<br>
+4. Obtain attributes of the **RelativeTimeFormat** object.
+
    Call the **resolvedOptions** method to obtain attributes of the **RelativeTimeFormat** object. This method will return an array that contains all attributes and values of the object. For a full list of attributes, see [ RelativeTimeFormatResolvedOptions](../reference/apis/js-apis-intl.md).
    
-   ```
+   ```js
    var options = numberFormat.resolvedOptions();
    ```

en/application-dev/reference/apis/js-apis-hitracemeter.md

 # Performance Tracing
 
-This module provides the functions of tracing service processes and monitoring the system performance. It provides the data needed for hiTraceMeter to carry out performance analysis.
+The Performance Tracing module provides the functions of tracing service processes and monitoring the system performance. It provides the data needed for hiTraceMeter to carry out performance analysis.
 
-> ![icon-note.gif](public_sys-resources/icon-note.gif) **NOTE**<br>
+> **NOTE**
+> 
 > The initial APIs of this module are supported since API version 8. Newly added APIs will be marked with a superscript to indicate their earliest API version.
 
 
@@ -17,7 +18,7 @@ import hiTraceMeter from '@ohos.hiTraceMeter';
 
 startTrace(name: string, taskId: number): void
 
-Starts a trace task. **expectedTime** is an optional parameter, which specifies the expected duration of the trace.
+Starts a trace task.
 
 If multiple trace tasks with the same name need to be performed at the same time or a trace task needs to be performed multiple times concurrently, different task IDs must be specified in **startTrace**.
 

en/application-dev/reference/apis/js-apis-logs.md

 # Log
 
-> ![icon-note.gif](public_sys-resources/icon-note.gif) **NOTE**
-> The APIs of this module are no longer maintained since API version 7. You are advised to use ['@ohos.hilog](js-apis-hilog.md)' instead.
+The Log module provides basic log printing capabilities and supports log printing by log level.
 
-## console.debug
-
-debug(message: string): void
+If you want to use more advanced log printing services, for example, filtering logs by the specified ID, you are advised to use [`@ohos.hilog`](js-apis-hilog.md).
 
-Prints debug logs.
-
-- Parameters
-  | Name    | Type    | Mandatory  | Description         |
-  | ------- | ------ | ---- | ----------- |
-  | message | string | Yes   | Text to print.|
+> **NOTE**
+>
+> The initial APIs of this module are supported since API version 3. Newly added APIs will be marked with a superscript to indicate their earliest API version.
 
 
 ## console.log
 
 log(message: string): void
 
-Prints debug logs.
+Prints logs.
+
+**System capability**: SystemCapability.ArkUI.ArkUI.Full
+
+**Parameters**
 
-- Parameters
-  | Name    | Type    | Mandatory  | Description         |
-  | ------- | ------ | ---- | ----------- |
-  | message | string | Yes   | Text to print.|
+| Name    | Type    | Mandatory  | Description         |
+| ------- | ------ | ---- | ----------- |
+| message | string | Yes   | Text to print.|
+
+
+## console.debug
+
+debug(message: string): void
+
+Prints debug-level logs.
+
+**System capability**: SystemCapability.ArkUI.ArkUI.Full
+
+**Parameters**
+
+| Name    | Type    | Mandatory  | Description         |
+| ------- | ------ | ---- | ----------- |
+| message | string | Yes   | Text to print.|
 
 
 ## console.info
@@ -33,10 +45,13 @@ info(message: string): void
 
 Prints info-level logs.
 
-- Parameters
-  | Name    | Type    | Mandatory  | Description         |
-  | ------- | ------ | ---- | ----------- |
-  | message | string | Yes   | Text to print.|
+**System capability**: SystemCapability.ArkUI.ArkUI.Full
+
+**Parameters**
+
+| Name    | Type    | Mandatory  | Description         |
+| ------- | ------ | ---- | ----------- |
+| message | string | Yes   | Text to print.|
 
 
 ## console.warn
@@ -45,10 +60,13 @@ warn(message: string): void
 
 Prints warn-level logs.
 
-- Parameters
-  | Name    | Type    | Mandatory  | Description         |
-  | ------- | ------ | ---- | ----------- |
-  | message | string | Yes   | Text to print.|
+**System capability**: SystemCapability.ArkUI.ArkUI.Full
+
+**Parameters**
+
+| Name    | Type    | Mandatory  | Description         |
+| ------- | ------ | ---- | ----------- |
+| message | string | Yes   | Text to print.|
 
 
 ## console.error
@@ -57,10 +75,13 @@ error(message: string): void
 
 Prints error-level logs.
 
-- Parameters
-  | Name    | Type    | Mandatory  | Description         |
-  | ------- | ------ | ---- | ----------- |
-  | message | string | Yes   | Text to print.|
+**System capability**: SystemCapability.ArkUI.ArkUI.Full
+
+**Parameters**
+
+| Name    | Type    | Mandatory  | Description         |
+| ------- | ------ | ---- | ----------- |
+| message | string | Yes   | Text to print.|
 
 
 ## Example

en/application-dev/reference/apis/js-apis-system-battery.md

 # Battery Level
 
-> ![icon-note.gif](public_sys-resources/icon-note.gif) **NOTE**
-> - The APIs of this module are no longer maintained since API version 7. It is recommended that you use [`@ohos.batteryInfo`](js-apis-battery-info.md) instead.
+>  **NOTE**
+> - The APIs of this module are no longer maintained since API version 6. You are advised to use [`@ohos.batteryInfo`](js-apis-battery-info.md).
 > 
 > - The initial APIs of this module are supported since API version 3. Newly added APIs will be marked with a superscript to indicate their earliest API version.
 
@@ -22,20 +22,13 @@ Obtains the current charging state and battery level.
 
 **System capability**: SystemCapability.PowerManager.BatteryManager.Core
 
-**Parameter**
+**Parameters**
 
-| Name | Type | Mandatory | Description |
+| Name| Type| Mandatory| Description|
 | -------- | -------- | -------- | -------- |
-| success | Function | No | Called when the check result is obtained |
-| fail | Function | No | Called when the check result fails to be obtained |
-| complete | Function | No | Called when the execution is complete |
-
-The following value will be returned when the check result is obtained.
-
-| Name | Type | Description |
-| -------- | -------- | -------- |
-| charging | boolean | Whether the battery is being charged |
-| level | number | Current battery level, which ranges from 0.00 to 1.00. |
+| success | (data: [BatteryResponse](#batteryresponse)) => void | No| Called when API call is successful.|
+| fail | (data: string, code: number) => void | No| Called when API call has failed.|
+| complete | () => void | No| Called when API call is complete.|
 
 **Example**
 
@@ -52,4 +45,11 @@ export default {
     });    
   },
 }
-```
\ No newline at end of file
+```
+
+## BatteryResponse
+
+| Name| Type| Description|
+| -------- | -------- | -------- |
+| charging | boolean | Whether the battery is being charged.|
+| level | number | Current battery level, which ranges from **0.00** to **1.00**.|

en/application-dev/reference/apis/js-apis-system-brightness.md

 # Screen Brightness
 
-> ![icon-note.gif](public_sys-resources/icon-note.gif) **NOTE**
-> - The APIs of this module are no longer maintained since API version 7. It is recommended that you use [`@ohos.brightness`](js-apis-brightness.md) instead.
+> **NOTE**
+> - The APIs of this module are no longer maintained since API version 7. You are advised to use [`@ohos.brightness`](js-apis-brightness.md).
 > 
 > - The initial APIs of this module are supported since API version 3. Newly added APIs will be marked with a superscript to indicate their earliest API version.
 
@@ -24,34 +24,35 @@ Obtains the current screen brightness.
 
 **Parameters**
 
-| Name | Type | Mandatory | Description |
+| Name| Type| Mandatory| Description|
 | -------- | -------- | -------- | -------- |
-| success | Function | No | Called when the execution is successful. |
-| fail | Function | No | Called when the operation fails. |
-| complete | Function | No | Called when the execution is complete |
+| success | (data: [BrightnessResponse](#brightnessresponse)) => void | No| Called when API call is successful.|
+| fail | (data: string, code: number) => void | No| Called when API call has failed.|
+| complete | () => void | No| Called when API call is complete.|
 
-The following values will be returned when the operation is successful.
+**Return value of success()**
 
-| Name | Type | Description |
+| Name| Type| Description|
 | -------- | -------- | -------- |
-| value | number | Screen brightness, which ranges from 1 to 255. |
+| value | number | Screen brightness. The value is an integer ranging from **1** to **255**.|
+
 
 **Example**
 
-```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);            
-      },
-    });    
-  },
-}
-```
+  ```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
@@ -64,30 +65,30 @@ Sets the screen brightness.
 
 **Parameters**
 
-| Name | Type | Mandatory | Description |
+| Name| Type| Mandatory| Description|
 | -------- | -------- | -------- | -------- |
-| value | number | Yes | Screen&nbsp;brightness.&nbsp;The&nbsp;value&nbsp;is&nbsp;an&nbsp;integer&nbsp;ranging&nbsp;from&nbsp;1&nbsp;to&nbsp;255.<br/>-&nbsp;If&nbsp;the&nbsp;value&nbsp;is&nbsp;less&nbsp;than&nbsp;or&nbsp;equal&nbsp;to&nbsp;**0**,&nbsp;value&nbsp;**1**&nbsp;will&nbsp;be&nbsp;used.<br/>-&nbsp;If&nbsp;the&nbsp;value&nbsp;is&nbsp;greater&nbsp;than&nbsp;**255**,&nbsp;value&nbsp;**255**&nbsp;will&nbsp;be&nbsp;used.<br/>-&nbsp;If&nbsp;the&nbsp;value&nbsp;contains&nbsp;decimals,&nbsp;the&nbsp;integral&nbsp;part&nbsp;of&nbsp;the&nbsp;value&nbsp;will&nbsp;be&nbsp;used.&nbsp;For&nbsp;example,&nbsp;if&nbsp;value&nbsp;**8.1**&nbsp;is&nbsp;set,&nbsp;value&nbsp;**8**&nbsp;will&nbsp;be&nbsp;used. |
-| success | Function | No | Called&nbsp;when&nbsp;the&nbsp;execution&nbsp;is&nbsp;successful. |
-| fail | Function | No | Called&nbsp;when&nbsp;the&nbsp;operation&nbsp;fails. |
-| complete | Function | No | Called&nbsp;when&nbsp;the&nbsp;execution&nbsp;is&nbsp;complete. |
+| value | number | Yes| Screen brightness. The value is an integer ranging from **1** to **255**.<br>- If the value is less than or equal to **0**, value **1** will be used.<br>- If the value is greater than **255**, value **255** will be used.<br>- If the value contains decimals, the integral part of the value will be used. For example, if value **8.1** is set, value **8** will be used.|
+| success | () => void | No| Called when API call is successful.|
+| fail | (data: string, code: number) => void | No| Called when API call has failed.|
+| complete | () => void | No| Called when API call is complete.|
 
 **Example**
 
-```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);            
-      },        
-    });    
-  },
-}
-```
+  ```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
@@ -100,34 +101,34 @@ Obtains the screen brightness adjustment mode.
 
 **Parameters**
 
-| Name | Type | Mandatory | Description |
+| Name| Type| Mandatory| Description|
 | -------- | -------- | -------- | -------- |
-| success | Function | No | Called&nbsp;when&nbsp;the&nbsp;execution&nbsp;is&nbsp;successful. |
-| fail | Function | No | Called&nbsp;when&nbsp;the&nbsp;operation&nbsp;fails. |
-| complete | Function | No | Called&nbsp;when&nbsp;the&nbsp;execution&nbsp;is&nbsp;complete |
+| success | (data: [BrightnessModeResponse](#brightnessmoderesponse)) => void | No| Called when API call is successful.|
+| fail | (data: string, code: number) => void | No| Called when API call has failed.|
+| complete | () => void | No| Called when API call is complete.|
 
-The following values will be returned when the operation is successful.
+**Return value of success()**
 
-| Name | Type | Description |
+| Name| Type| Description|
 | -------- | -------- | -------- |
-| mode | number | The&nbsp;value&nbsp;can&nbsp;be&nbsp;**0**&nbsp;or&nbsp;**1**.<br/>-&nbsp;**0**:&nbsp;The&nbsp;screen&nbsp;brightness&nbsp;is&nbsp;manually&nbsp;adjusted.<br/>-&nbsp;**1**:&nbsp;The&nbsp;screen&nbsp;brightness&nbsp;is&nbsp;automatically&nbsp;adjusted. |
+| mode | number | The value can be **0** or **1**.<br>- **0**: manual adjustment<br>- **1**: automatic adjustment|
 
 **Example**
 
-```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);            
-      },
-    });    
-  },
-}
-```
+  ```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
@@ -139,31 +140,30 @@ Sets the screen brightness adjustment mode.
 **System capability**: SystemCapability.PowerManager.DisplayPowerManager
 
 **Parameters**
-
-| Name | Type | Mandatory | Description |
+| Name| Type| Mandatory| Description|
 | -------- | -------- | -------- | -------- |
-| mode | number | Yes | The&nbsp;value&nbsp;can&nbsp;be&nbsp;**0**&nbsp;or&nbsp;**1**.<br/>-&nbsp;**0**:&nbsp;The&nbsp;screen&nbsp;brightness&nbsp;is&nbsp;manually&nbsp;adjusted.<br/>-&nbsp;**1**:&nbsp;The&nbsp;screen&nbsp;brightness&nbsp;is&nbsp;automatically&nbsp;adjusted. |
-| success | Function | No | Called&nbsp;when&nbsp;the&nbsp;execution&nbsp;is&nbsp;successful. |
-| fail | Function | No | Called&nbsp;when&nbsp;the&nbsp;operation&nbsp;fails. |
-| complete | Function | No | Called&nbsp;when&nbsp;the&nbsp;execution&nbsp;is&nbsp;complete. |
+| mode | number | Yes| The value can be **0** or **1**.<br>- **0**: manual adjustment<br>- **1**: automatic adjustment|
+| success | () => void | No| Called when API call is successful.|
+| fail | (data: string, code: number) => void | No| Called when API call has failed.|
+| complete | () => void | No| Called when API call is complete.|
 
 **Example**
 
-```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);            
-     },
-    });    
-  },
-}
-```
+  ```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
@@ -175,28 +175,40 @@ Sets whether to always keep the screen on. Call this API in **onShow()**.
 **System capability**: SystemCapability.PowerManager.DisplayPowerManager
 
 **Parameters**
-
-| Name | Type | Mandatory | Description |
+| Name| Type| Mandatory| Description|
 | -------- | -------- | -------- | -------- |
-| keepScreenOn | boolean | Yes | Whether&nbsp;to&nbsp;always&nbsp;keep&nbsp;the&nbsp;screen&nbsp;on |
-| success | Function | No | Called&nbsp;when&nbsp;the&nbsp;execution&nbsp;is&nbsp;successful. |
-| fail | Function | No | Called&nbsp;when&nbsp;the&nbsp;operation&nbsp;fails. |
-| complete | Function | No | Called&nbsp;when&nbsp;the&nbsp;execution&nbsp;is&nbsp;complete. |
+| keepScreenOn | boolean | Yes| Whether to keep the screen on.|
+| success | () => void | No| Called when API call is successful.|
+| fail | (data: string, code: number) => void | No| Called when API call has failed.|
+| complete | () => void | No| Called when API call is complete.|
 
 **Example**
 
-```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);            
-      },        
-    });    
-  },
-}
-```
\ No newline at end of file
+  ```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
+
+| Name| Type | Description|
+| -------- | -------- | -------- |
+| value | number | Screen brightness. The value is an integer ranging from **1** to **255**.|
+
+## BrightnessModeResponse
+
+| Name| Type | Description|
+| -------- | -------- | -------- |
+| mode | number | The value can be **0** or **1**.<br> - **0**: manual adjustment<br>- **0**: manual adjustment|