!2275 帐号+多模文档修改+网站目录更新

Merge pull request !2275 from zengyawen/master

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

+# Sensor Development
+
+
+## When to Use
+
+- Data provided by the compass sensor denotes the current orientation of the user device, which helps your application accurately navigate for the user.
+
+- Data provided by the proximity sensor denotes the distance between the device and a visible object, which enables the device to automatically turn on or off its screen accordingly to prevent accidental touch on the screen.
+
+- Data provided by the barometer sensor helps your application accurately determine the altitude of the device.
+
+- Data provided by the ambient light sensor helps your device automatically adjust its backlight.
+
+- Data provided by the Hall effect sensor implements the smart cover mode of your device.
+
+- Data provided by the heart rate sensor helps your application track the health of a user.
+
+- Data provided by the pedometer sensor helps your application obtain the number steps a user has walked.
+
+- Data provided by the wear detection sensor helps your application detect whether a user is wearing a wearable device.
+
+
+## Available APIs
+
+  | Module | API | Description | 
+| -------- | -------- | -------- |
+| ohos.sensor | sensor.on(sensorType,callback:AsyncCallback<Response>):void | Subscribes to data changes of a type of sensor. | 
+| ohos.sensor | sensor.once(sensorType,callback:AsyncCallback<Response>):void | Subscribes to only one data change of a type of sensor. | 
+| ohos.sensor | sensor.off(sensorType,callback:AsyncCallback<void>):void | Unsubscribes from sensor data changes. | 
+
+
+## How to Develop
+
+1. To obtain data from a type of sensor, configure the request permissions in the **config.json** file.
+  
+   ```
+   "reqPermissions":[
+     {
+        "name":"ohos.permission.ACCELEROMETER",
+        "reason"":"", 
+        "usedScene":{
+         "ability": ["sensor.index.MainAbility",".MainAbility"],
+         "when":"inuse"
+       }
+     },
+     {
+        "name":"ohos.permission.GYROSCOPE",
+        "reason"":"", 
+        "usedScene":{
+         "ability": ["sensor.index.MainAbility",".MainAbility"],
+         "when":"inuse"
+       }
+     },
+     {
+        "name":"ohos.permission.ACTIVITY_MOTION",
+        "reason"":"ACTIVITY_MOTION_TEST", 
+        "usedScene":{
+         "ability": ["sensor.index.MainAbility",".MainAbility"],
+         "when":"inuse"
+       }
+     },
+     {
+        "name":"ohos.permission.READ_HEALTH_DATA",
+        "reason"":"HEALTH_DATA_TEST", 
+        "usedScene":{
+         "ability": ["sensor.index.MainAbility",".MainAbility"],
+         "when":"inuse"
+       }
+     },
+     {
+        "name":"ohos.permission.VIBRATE",
+        "reason"":"", 
+        "usedScene":{
+         "ability": [".MainAbility"],
+         "when":"inuse"
+       }
+     },
+   ]
+   ```
+
+2. Subscribe to data changes of a type of sensor.
+  
+   ```
+   import sensor from "@ohos.sensor"
+   sensor.on(type:sensorType,function(error,data){
+       if (error) {// The call fails, and error.code and error.message are printed.
+           console.error("Subscription failed. Error code: " + error.code + "; message: " + error.message);
+           return;
+       };
+          console.info("Subscription succeeded. data = "+ data);// The call is successful, and the obtained sensor data is printed.
+     }
+   );
+   ```
+
+   The following figure shows the successful call result when **SensorType** is **SENSOR_TYPE_ID_ACCELEROMETER**.
+
+   ![en-us_image_0000001241693881](figures/en-us_image_0000001241693881.png)
+
+3. Unsubscribe from sensor data changes.
+  
+   ```
+   import sensor from "@ohos.sensor"
+   sensor.off(type:sensorType,function(error) {
+       if (error) {// The unsubscription fails, and error.code and error.message are printed.
+           console.error("Failed to unsubscribe from acceleration sensor data. Error code: " + error.code + "; message: " + error.message);
+           return;
+       };
+       console.info("Succeeded in unsubscribing from acceleration sensor data.");// The unsubscription is successful, and the result is printed.
+     }
+   );
+   ```
+
+   The following figure shows the successful call result when **SensorType** is **SENSOR_TYPE_ID_ACCELEROMETER**.
+
+   ![en-us_image_0000001196654004](figures/en-us_image_0000001196654004.png)
+
+4. Subscribe to only one data change of a type of sensor.
+  
+   ```
+   import sensor from "@ohos.sensor"
+   sensor.once(tyep:sensorType,function(error, data) {
+       if (error) {// The call fails, and error.code and error.message are printed.
+           console.error("Failed to obtain data. Error code: " + error.code + "; message: " + error.message);
+           return;
+       };
+           console.info("Data obtained successfully. data="+data);// The call is successful, and the obtained sensor data is printed.
+     }
+   );
+   ```
+
+   The following figure shows the successful call result when **SensorType** is **SENSOR_TYPE_ID_ACCELEROMETER**.
+
+   ![en-us_image_0000001241733907](figures/en-us_image_0000001241733907.png)

en/application-dev/device/sensor-overview.md

+# Sensor Overview
+
+
+Sensors in OpenHarmony are an abstraction of underlying hardware-based sensors. Your application can access the underlying sensors via OpenHarmony sensors. Using the APIs provided by OpenHarmony sensors, you can query sensors on your device, subscribe to sensor data, customize algorithms based on sensor data, and develop various sensor-based applications, such as compass, fitness and health, and games applications.
+
+
+The sensors are classified into the following categories based on their functions: motion, environment, orientation, light, body, and other categories (such as Hall effect sensors). Each category includes different sensor types. A sensor type may be a single physical sensor or a composite of multiple physical sensors.
+
+
+  **Table1** Motion - ohos.sensor.agent.CategoryMotionAgent
+
+| Sensor Type | Sensor Name | Description | Usage | 
+| -------- | -------- | -------- | -------- |
+| SENSOR_TYPE_ACCELEROMETER | Acceleration sensor | Measures the acceleration (including the gravity acceleration) applied to a device on three physical axes (X, Y, and Z), in the unit of m/s<sup>2</sup>. | Detecting the motion status | 
+| SENSOR_TYPE_ACCELEROMETER_UNCALIBRATED | Uncalibrated acceleration sensor | Measures the uncalibrated acceleration (including the gravity acceleration) applied to a device on three physical axes (X, Y, and Z), in the unit of m/s<sup>2</sup>. | Measuring the acceleration bias estimation | 
+| SENSOR_TYPE_LINEAR_ACCELERATION | Linear acceleration sensor | Measures the linear acceleration (excluding the gravity acceleration) applied to a device on three physical axes (X, Y, and Z), in the unit of m/s<sup>2</sup>. | Detecting the linear acceleration in each axis | 
+| SENSOR_TYPE_GRAVITY | Gravity sensor | Measures the gravity acceleration applied to a device on three physical axes (X, Y, and Z), in the unit of m/s<sup>2</sup>. | Measuring the gravity | 
+| SENSOR_TYPE_GYROSCOPE | Gyroscope sensor | Measures the rotation angular velocity of a device on three physical axes (X, Y, and Z), in the unit of rad/s. | Measuring the rotation angular velocity | 
+| SENSOR_TYPE_GYROSCOPE_UNCALIBRATED | Uncalibrated gyroscope sensor | Measures the uncalibrated rotation angular velocity of a device on three physical axes (X, Y, and Z), in the unit of rad/s. | Measuring the bias estimation of the rotation angular velocity | 
+| SENSOR_TYPE_SIGNIFICANT_MOTION | Significant motion sensor | Checks whether a device has a significant motion on three physical axes (X, Y, and Z). The value can be **0** (having no significant motion) or **1** (having a significant motion). | Detecting significant motions of a device | 
+| SENSOR_TYPE_DROP_DETECTION | Drop detection sensor | Detects the device drop status. The value can be **0** (the device is not dropped) or **1** (the device is dropped). | Detecting whether a device is dropped | 
+| SENSOR_TYPE_PEDOMETER_DETECTION | Pedometer detection sensor | Detects whether a user takes a step. The value can be **0** (the user does not take a step) or **1** (the user takes a step). | Detecting whether a user takes a step | 
+| SENSOR_TYPE_PEDOMETER | Pedometer sensor | Records the number of steps a user has walked. | Providing the number of steps a user has walked | 
+
+
+  **Table2** Environment - ohos.sensor.agent.CategoryOrientationAgent
+
+| Sensor Type | Sensor Name | Description | Usage | 
+| -------- | -------- | -------- | -------- |
+| SENSOR_TYPE_AMBIENT_TEMPERATURE | Ambient temperature sensor. | Measures the ambient temperature, in the unit of degree Celsius (°C). | Measuring the ambient temperature | 
+| SENSOR_TYPE_MAGNETIC_FIELD | Magnetic field sensor | Measures the magnetic field on three physical axes (X, Y, and Z), in the unit of μT. | Creating a compass | 
+| SENSOR_TYPE_MAGNETIC_FIELD_UNCALIBRATED | Uncalibrated magnetic field sensor | Measures the uncalibrated magnetic field on three physical axes (X, Y, and Z), in the unit of μT. | Measuring the magnetic field bias estimation | 
+| SENSOR_TYPE_HUMIDITY | Humidity sensor | Measures the ambient relative humidity, in a percentage (%). | Monitoring the dew point, absolute humidity, and relative humidity | 
+| SENSOR_TYPE_BAROMETER | Barometer sensor | Measures the barometric pressure, in the unit of hPa or mbar. | Measuring the barometric pressure | 
+| SENSOR_TYPE_SAR | Specific Absorption Rate (SAR) sensor | Measures the SAR, in the unit of W/kg. | Measuring the SAR of electromagnetic waves for a device | 
+
+
+  **Table3** Orientation - ohos.sensor.agent.CategoryOrientationAgent
+
+| Sensor Type | Sensor Name | Description | Usage | 
+| -------- | -------- | -------- | -------- |
+| SENSOR_TYPE_6DOF | Degrees of Freedom (DoF) sensor | Measures the forward/backward, up/down, and left/right translational movement of a device on the three axes (X, Y, and Z) in the unit of m or mm as well as the roll, pitch, and yaw rotation angles on the three axes (X, Y, and Z) in the unit of rad. | Positioning an object by detecting its freedom of translational and rotational motions, for example, VR | 
+| SENSOR_TYPE_SCREEN_ROTATION | Screen rotation sensor | Checks the rotation status of the device screen. | Detecting whether the device screen is rotating | 
+| SENSOR_TYPE_DEVICE_ORIENTATION | Device orientation sensor | Measures the rotation angles of the device, in the unit of rad. | Measuring the angles that a device has rotated | 
+| SENSOR_TYPE_ORIENTATION | Orientation sensor | Measures the rotation angles of a device on three physical axes (X, Y, and Z), in the unit of rad. | Providing the three orientation angles of the screen | 
+| SENSOR_TYPE_ROTATION_VECTOR | Rotation vector sensor | Measures the rotation vector of a device. It is a composite sensor that generates data from the acceleration sensor, magnetic field sensor, and gyroscope sensor. | Detecting the orientation of a device in the East, North, Up (ENU) Cartesian coordinate system | 
+| SENSOR_TYPE_GAME_ROTATION_VECTOR<br/>SENSOR_TYPE_GEOMAGNETIC_ROTATION_VECTOR | Game rotation vector sensor<br/>Geomagnetic rotation vector sensor | Measures the game rotation vector of a device. It is a composite sensor that generates data from the acceleration sensor and gyroscope sensor.<br/>Measures the geomagnetic rotation vector of a device. It is a composite sensor that generates data from the acceleration sensor and magnetic field sensor. | Applied in games<br/>Measuring the geomagnetic rotation vector | 
+
+
+  **Table4** Light - ohos.sensor.agent.CategoryLightAgent
+
+| Sensor Type | Sensor Name | Description | Usage | 
+| -------- | -------- | -------- | -------- |
+| SENSOR_TYPE_PROXIMITY | Proximity sensor | Measures the distance between a visible object and the device screen. | Measuring the distance between a person and the device during a call | 
+| SENSOR_TYPE_TOF | Time of flight (ToF) sensor | Measures the time required for light to travel a distance in the medium. | Facial recognition | 
+| SENSOR_TYPE_AMBIENT_LIGHT | Ambient light sensor | Measures the ambient light intensity of a device, in the unit of lux. | Automatically adjusting the screen brightness and checking whether the screen is covered on the top | 
+| SENSOR_TYPE_COLOR_TEMPERATURE | Color temperature sensor | Measures the ambient color temperature. | Image processing on the device | 
+| SENSOR_TYPE_COLOR_RGB | RGB color sensor | Measures the ambient RGB color values. | Color detection implemented by the reflectance of RGB colors | 
+| SENSOR_TYPE_COLOR_XYZ | XYZ color sensor | Measures the ambient XYZ color values. | Identifying true-color spots to reproduce more natural colors | 
+
+
+  **Table5** Body - ohos.sensor.agent.CategoryBodyAgent
+
+| Sensor Type | Sensor Name | Description | Usage | 
+| -------- | -------- | -------- | -------- |
+| SENSOR_TYPE_HEART_RATE | Heart rate sensor | Measures the heart rate of a user. | Providing users' heart rate data | 
+| SENSOR_TYPE_WEAR_DETECTION | Wear detection sensor | Checks whether a user is wearing a wearable device. | Detecting wearables | 
+
+
+  **Table6** Others
+
+| Sensor Type | Sensor Name | Description | Usage | 
+| -------- | -------- | -------- | -------- |
+| SENSOR_TYPE_HALL | Hall effect sensor | Detects a magnetic field around a device. | Smart cover mode of the device | 
+| SENSOR_TYPE_GRIP_DETECTOR | Grip detection sensor | Detects grip force applied on a device. | Detecting whether the device is gripped on its sides | 
+| SENSOR_TYPE_MAGNET_BRACKET | Magnet bracket sensor | Checks whether a device is magnetized. | Detecting an in-vehicle or indoor device | 
+| SENSOR_TYPE_PRESSURE_DETECTOR | Pressure detection sensor | Detects pressure force applied on a device. | Detecting pressure on the top of the device | 
+
+
+## How a Service Is Shared Using Huawei Share
+
+The following modules work cooperatively to implement OpenHarmony sensors: Sensor API, Sensor Framework, Sensor Service, and HD_IDL.
+
+  **Figure1** Working principles for OpenHarmony sensors
+  ![en-us_image_0000001226521897](figures/en-us_image_0000001226521897.png)
+
+- Sensor API: provides APIs for performing basic operations on sensors, including querying the sensor list, subscribing to or unsubscribing from sensor data, and executing control commands. This module makes application development simpler.
+
+- Sensor Framework: manages sensor data subscription, creates and destroys data channels, subscribes to or unsubscribes from sensor data, and implements communication with the Sensor Service module.
+
+- Sensor Service: interacts with the HD_IDL module to receive, parse, and distribute data, manages foreground and background policies and sensors of a device, and controls sensor permissions.
+
+- HD_IDL: selects proper policies based on the hardware first in first out (FIFO) and frequency, and adapts to different devices.
+
+
+## Limitations and Constraints
+
+To obtain data of the following sensors, you must claim the required permissions.
+
+
+  **Table7** Sensor data permission
+
+| Sensor | Permission Name | Sensitivity | Permission Description | 
+| -------- | -------- | -------- | -------- |
+| Acceleration sensor, uncalibrated acceleration sensor, and linear acceleration sensor | ohos.permission.ACCELEROMETER | system_grant | Allows your application to subscribe to data of these acceleration-related sensors in the motion category. | 
+| Gyroscope sensor and uncalibrated gyroscope sensor | ohos.permission.GYROSCOPE | system_grant | Allows your application to subscribe to data of these gyroscope-related sensors in the motion category. | 
+| Pedometer sensor | ohos.permission.ACTIVITY_MOTION | user_grant | Allows your application to subscribe to the motion status. | 
+| Heart rate sensor | ohos.permission.READ_HEALTH_DATA | user_grant | Allows your application to read health data. | 
+
+
+The APIs for subscribing to and unsubscribing from sensor data work in pairs. If you do not need sensor data, call the unsubscription API to stop sensor data reporting.

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

+# Combination Key
+
+
+> ![icon-note.gif](public_sys-resources/icon-note.gif) **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.
+> 
+> - The APIs of this module are system APIs and cannot be called by third-party applications.
+
+
+## Modules to Import
+
+
+```
+import inputConsumer from '@ohos.multimodalInput.inputConsumer';
+```
+
+
+## inputConsumer.on
+
+on(type: "key", keyOption: KeyOption, callback: Callback<KeyOption>): void
+
+Enables listening for combination key events. When a combination key event that meets the specified conditions occurs, **keyOption** will be passed as an input parameter to **callback**.
+
+**System capability**: SystemCapability.MultimodalInput.Input.InputConsumer
+
+  **Parameters**
+  | Name | Type | Mandatory | Description | 
+| -------- | -------- | -------- | -------- |
+| type | string | Yes | Type of the key input event to listen for. Only **key** is supported. | 
+| keyOption | [KeyOption](#keyoption) | Yes | Key option, which specifies the condition for combination key input. | 
+| callback | Callback<KeyOption> | Yes | Callback function. When a key input event that meets the specified options occurs, **keyOption** will be passed as an input parameter to **callback**. | 
+
+  **Example**
+
+```
+let keyOption = {preKeys: [], finalKey: 3, isFinalKeyDown: true, finalKeyDownDuration: 0}
+let callback = function(keyOption) {
+    console.info("preKeys: " + keyOption.preKeys, "finalKey: " + keyOption.finalKey, 
+                 "isFinalKeyDown: " + keyOption.isFinalKeyDown, "finalKeyDownDuration: " + keyOption.finalKeyDownDuration)
+}
+inputConsumer.on('key', keyOption, callback);
+```
+
+
+## inputConsumer.off
+
+off(type: "key", keyOption: KeyOption, callback: Callback<KeyOption>): void
+
+Stops listening for combination key events.
+
+**System capability**: SystemCapability.MultimodalInput.Input.InputConsumer
+
+  **Parameters**
+  | Name | Type | Mandatory | Description | 
+| -------- | -------- | -------- | -------- |
+| type | string | Yes | Type of the key input event to listen for. Only **key** is supported. | 
+| keyOption | [KeyOption](#keyoption) | Yes | Key option passed to the key input event when listening starts. | 
+| callback | Callback<KeyOption> | Yes | Callback function passed to the key input event with the key option when listening starts. | 
+
+  **Example**
+
+```
+let keyOption = {preKeys: [], finalKey: 3, isFinalKeyDown: true, finalKeyDownDuration: 0}
+let callback = function(keyOption) {
+    console.info("preKeys: " + keyOption.preKeys, "finalKey: " + keyOption.finalKey, 
+                 "isFinalKeyDown: " + keyOption.isFinalKeyDown, "finalKeyDownDuration: " + keyOption.finalKeyDownDuration)
+}
+inputConsumer.off('key', keyOption, callback);
+```
+
+
+## KeyOption
+
+Defines the key options that are met when a combination key input event occurs.
+
+  **System capability**: SystemCapability.MultimodalInput.Input.InputConsumer
+  | Name | Type | Mandatory | Description | 
+| -------- | -------- | -------- | -------- |
+| preKeys | Array | Yes | Array of precedent keys. This parameter can be left empty. There is no requirement on the sequence of precedent keys. | 
+| finalKey | Number | Yes | Final key in the combination key. This parameter cannot be left blank. | 
+| isFinalKeyDown | boolean | Yes | Indicates whether the final key is pressed or released. By default, the final key is pressed. | 
+| finalKeyDownDuration | Number | Yes | Duration for pressing the final key. By default, there is no requirement on the duration. | 

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

+# Input Device
+
+
+The input device management module is used to listen for the connection, disconnection, and updates of input devices and display information about input devices. For example, it can be used to listen for mouse insertion and removal and obtain information such as the ID, name, and pointer speed of the mouse.
+
+
+> ![icon-note.gif](public_sys-resources/icon-note.gif) **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.
+
+
+## Modules to Import
+
+
+```
+import inputDevice from '@ohos.multimodalInput.inputDevice';
+```
+
+
+## inputDevice.getDeviceIds
+
+getDeviceIds(callback: AsyncCallback<Array<number>>): void
+
+Obtains the IDs of all input devices. This method uses an asynchronous callback to return the result.
+
+**System capability**: SystemCapability.MultimodalInput.Input.InputDevice
+
+  **Parameters**
+  | Name | Type | Mandatory | Description | 
+| -------- | -------- | -------- | -------- |
+| callback | AsyncCallback<Array<number>> | Yes | Callback used to return the result. | 
+
+  **Example**
+
+```
+data: {
+    deviceIds: Array,
+},
+callback: function(ids) {
+    this.deviceIds = ids;
+},
+testGetDeviceIds: function () {
+    console.info("InputDeviceJsTest---start---testGetDeviceIds");
+    inputDevice.getDeviceIds(this.callback);
+    console.info("InputDeviceJsTest---end---testGetDeviceIds");
+}
+```
+
+
+## inputDevice.getDevice
+
+getDevice(deviceId: number, callback: AsyncCallback<InputDeviceData>): void
+
+Obtains the information about an input device. This method uses an asynchronous callback to return the result.
+
+**System capability**: SystemCapability.MultimodalInput.Input.InputDevice
+
+  **Parameters**
+  | Name | Type | Mandatory | Description | 
+| -------- | -------- | -------- | -------- |
+| deviceId | number | Yes | ID of the input device whose information is to be obtained. | 
+| callback | AsyncCallback<[InputDeviceData](#inputdevicedata)> | Yes | Callback used to return the **InputDeviceData** object. | 
+
+  **Example**
+
+```
+InputDeviceData {
+    deviceId : 0,
+    name : "NA",
+    sources : Array,
+    axisRanges : Array,
+},
+callback: function(deviceData) {
+    this.InputDeviceData = deviceData;
+},
+testGetDevice: function () {
+    // The example is used to obtain the information about the device whose ID is 1.
+    console.info("InputDeviceJsTest---start---testGetDevice");
+    inputDevice.getDevice(1, this.callback);
+    console.info("InputDeviceJsTest---end---testGetDevice");
+}
+```
+
+
+## InputDeviceData
+
+Defines the information about an input device.
+
+  **System capability**: SystemCapability.MultimodalInput.Input.InputDevice
+  | Name | Type | Description | 
+| -------- | -------- | -------- |
+| id | number | Unique identifier of an input device. If the same physical device is repeatedly inserted and removed, its ID changes. | 
+| name | string | Name of the input device. | 
+| sources | Array<[SourceType](#sourcetype)> | Source types of the input device. For example, if a keyboard is attached with a touchpad, the device has two input sources: keyboard and touchpad. |
+
+
+## SourceType
+
+Enumerates the input source types.
+
+**System capability**: SystemCapability.MultimodalInput.Input.InputDevice
+
+  | Name | Type | Description | 
+| -------- | -------- | -------- |
+| keyboard | string | The input device is a keyboard. |
+| touchscreen | string | The input device is a touchscreen. | 
+| mouse | string | The input device is a mouse. |
+| trackball | string | The input device is a trackball. |
+| touchpad | string | The input device is a touchpad. |
+| joystick | string | The input device is a joystick. |

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

+# Input Monitor
+
+
+> ![icon-note.gif](public_sys-resources/icon-note.gif) **NOTE**
+> - The initial APIs of this module are supported since API version 7. Newly added APIs will be marked with a superscript to indicate their earliest API version.
+> 
+> - The APIs of this module are system APIs and cannot be called by third-party applications.
+
+
+## Modules to Import
+
+
+```
+import inputMonitor from '@ohos.multimodalInput.inputMonitor';
+```
+
+
+## Required Permissions
+
+ohos.permission.INPUT_MONITORING
+
+
+## inputMonitor.on
+
+on(type: "touch", receiver: TouchEventReceiver): void
+
+Starts listening for global input events.
+
+**Required permissions**: ohos.permission.INPUT_MONITORING
+
+**System capability**: SystemCapability.MultimodalInput.Input.InputMonitor
+
+  **Parameters**
+  | Parameter | Type | Mandatory | Description | 
+| -------- | -------- | -------- | -------- |
+| type | string | Yes | Type of the input event. Currently, only **touch** events are supported. | 
+| receiver | [TouchEventReceiver](#toucheventreceiver) | Yes | Callback used to return the touch event. | 
+
+  **Example**
+
+```
+callback: function (value) {
+    if (checkEvent(value)) {
+            // The event meets the service requirement and is consumed.
+        return true;
+    } else {
+            // The event does not meet the service requirement and is not consumed.
+        return false;
+    }
+},
+testOn: function () {
+    console.info("InputMonitorJsTest---start---testOn");
+    inputMonitor.on(
+        "touch",
+        this.callback
+    );
+    console.info("InputMonitorJsTest---end---testOn");
+}
+```
+
+
+## inputMonitor.off
+
+off(type: "touch", receiver: TouchEventReceiver): void
+
+Stops listening for global input events.
+
+**Required permissions**: ohos.permission.INPUT_MONITORING
+
+**System capability**: SystemCapability.MultimodalInput.Input.InputMonitor
+
+  **Parameters**
+  | Parameter | Type | Mandatory | Description | 
+| -------- | -------- | -------- | -------- |
+| type | string | Yes | Type of the input event. Currently, only **touch** events are supported. | 
+| receiver | [TouchEventReceiver](#toucheventreceiver) | No | Callback used to return the touch event. | 
+
+  **Example**
+
+```
+callback: function (value) {
+    if (checkEvent(value)) {
+            // The event meets the service requirement and is consumed.
+        return true;
+    } else {
+            // The event does not meet the service requirement and is not consumed.
+        return false;
+    }
+},
+testOff: function () {
+    console.info("InputMonitorJsTest---start---testOff");
+    inputMonitor.off(
+        "touch",
+        this.callback
+    );
+    console.info("InputMonitorJsTest---end---testOff");
+}
+```
+
+
+## TouchEventReceiver
+
+Represents the class of the callback used to return the touch event. The value **true** indicates that the touch event has been consumed, and the value **false** indicates the opposite.
+
+
+### (touchEvent: TouchEvent): Boolean
+
+Represents the callback used to return the touch event. You need to define the name of the callback function in the correct format. Ensure that the input parameter is of the **TouchEvent** type, and the return value is of the **Boolean** type.
+
+**System capability**: SystemCapability.MultimodalInput.Input.InputMonitor
+
+  **Parameters**
+| Parameter | Type | Mandatory | Description |
+| -------- | -------- | -------- | -------- |
+| touchEvent | [TouchEvent](../arkui-js/js-components-common-events.md) | Yes | Callback used to return the touch event. |
+
+  **Return value**
+  | Type | Description | 
+| -------- | -------- |
+| Boolean | Result indicating whether the touch event has been consumed by the input monitor. The value **true** indicates that the touch event has been consumed, and the value **false** indicates the opposite. | 
+
+  **Example**
+
+```
+callback: function (value) {// Implementation of the (touchEvent:TouchEvent): Boolean API.
+    if (checkEvent(value)) {
+            // The event meets the service requirement and is consumed.
+        return true;
+    } else {
+            // The event does not meet the service requirement and is not consumed.
+        return false;
+    }
+},
+testOff: function () {
+    console.info("InputMonitorJsTest---start---testOff");
+    inputMonitor.off(
+        "touch",
+        this.callback
+    );
+    console.info("InputMonitorJsTest---end---testOff");
+}
+```

en/overview-website-en.md

+# Learn About OpenHarmony
+
+- [OpenHarmony Project](OpenHarmony-Overview.md)
+- [Glossary](device-dev/glossary/glossary.md)
+- OpenHarmony Release Notes
+  - OpenHarmony 3.x Releases
+    -   [OpenHarmony v3.1 Beta (2021-12-31)](release-notes/OpenHarmony-v3.1-beta.md)
+    -   [OpenHarmony v3.0.1 LTS (2022-01-12)](release-notes/OpenHarmony-v3.0.1-LTS.md)
+    -   [OpenHarmony v3.0 LTS (2021-09-30)](release-notes/OpenHarmony-v3.0-LTS.md)
+
+  - OpenHarmony 2.x Releases
+    -   [OpenHarmony v2.2 beta2 (2021-08-04)](release-notes/OpenHarmony-v2.2-beta2.md)
+    -   [OpenHarmony 2.0 Canary (2021-06-01)](release-notes/OpenHarmony-2-0-Canary.md)
+
+  -  OpenHarmony 1.x Releases
+    -   [OpenHarmony v1.1.4 LTS (2022-02-11)](release-notes/OpenHarmony-v1-1-4-LTS.md)
+    -   [OpenHarmony v1.1.3 LTS (2021-09-30)](release-notes/OpenHarmony-v1-1-3-LTS.md)
+    -   [OpenHarmony v1.1.2 LTS (2021-08-04)](release-notes/OpenHarmony-v1.1.2-LTS.md)
+    -   [OpenHarmony 1.1.1 LTS (2021-06-22)](release-notes/OpenHarmony-1-1-1-LTS.md)
+    -   [OpenHarmony 1.1.0 LTS (2021-04-01)](release-notes/OpenHarmony-1-1-0-LTS.md)
+    -   [OpenHarmony 1.0 (2020-09-10)](release-notes/OpenHarmony-1-0.md)
+- Contribution
+  - [Contribution](contribute/contribution.md)
+  - [Code of Conduct](contribute/code-of-conduct.md)
+  - [Code Contribution](contribute/code-contribution.md)
+  - [Contribution Process](contribute/contribution-process.md)
+  - [Auto-Test](readme/test_subsystem.md)
+  - [Documentation Contribution](contribute/documentation-contribution.md)
+  - [Writing Instructions](contribute/writing-instructions.md)
+  - [Communication in Community](contribute/communication-in-community.md)
+  - [FAQs](contribute/FAQ.md)
\ No newline at end of file

zh-cn/application-dev/reference/apis/js-apis-contact.md

@@ -461,7 +461,7 @@ queryMyCard(attrs?: ContactAttributes): Promise<Contact>
 
 ## contact.selectContact
 
-selectContact(AsyncCallback<Array<Contact>>): void
+selectContact(callback: AsyncCallback<Array<Contact>>): void
 
 选择联系人，使用callback方式作为异步方法。
 

zh-cn/application-dev/reference/apis/js-apis-inputmonitor.md

+# 输入监听
+
+
+> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
+> - 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
+> 
+> - 本模块接口均为系统接口，三方应用不支持调用。
+
+
+## 导入模块
+
+
+```
+import inputMonitor from '@ohos.multimodalInput.inputMonitor';
+```
+
+
+## 权限
+
+ohos.permission.INPUT_MONITORING
+
+
+## inputMonitor.on
+
+on(type: "touch", receiver: TouchEventReceiver): void
+
+开始监听全局输入。
+
+**需要权限：**ohos.permission.INPUT_MONITORING
+
+**系统能力：**SystemCapability.MultimodalInput.Input.InputMonitor
+
+  **参数：**
+  | 参数 | 类型 | 必填 | 说明 | 
+| -------- | -------- | -------- | -------- |
+| type | string | 是 | 监听输入事件类型，只支持“touch”。 | 
+| receiver | [TouchEventReceiver](#toucheventreceiver) | 是 | 触摸输入事件回调函数。 | 
+
+  **示例：**
+
+```
+callback: function (value) {
+    if (checkEvent(value)) {
+        //事件满足业务要求，事件被消费
+        return true;
+    } else {
+        //事件不满足业务要求，事件未被消费
+        return false;
+    }
+},
+testOn: function () {
+    console.info("InputMonitorJsTest---start---testOn");
+    inputMonitor.on(
+        "touch",
+        this.callback
+    );
+    console.info("InputMonitorJsTest---end---testOn");
+}
+```
+
+
+## inputMonitor.off
+
+off(type: "touch", receiver: TouchEventReceiver): void
+
+停止监听全局输入。
+
+**需要权限：**ohos.permission.INPUT_MONITORING
+
+**系统能力：**SystemCapability.MultimodalInput.Input.InputMonitor
+
+  **参数：**
+  | 参数 | 类型 | 必填 | 说明 | 
+| -------- | -------- | -------- | -------- |
+| type | string | 是 | 监听输入事件类型，只支持“touch”。 | 
+| receiver | [TouchEventReceiver](#toucheventreceiver) | 否 | 触摸输入事件回调函数。 | 
+
+  **示例：**
+
+```
+callback: function (value) {
+    if (checkEvent(value)) {
+        //事件满足业务要求，事件被消费
+        return true;
+    } else {
+        //事件不满足业务要求，事件未被消费
+        return false;
+    }
+},
+testOff: function () {
+    console.info("InputMonitorJsTest---start---testOff");
+    inputMonitor.off(
+        "touch",
+        this.callback
+    );
+    console.info("InputMonitorJsTest---end---testOff");
+}
+```
+
+
+## TouchEventReceiver
+
+触摸输入事件的回调函数，如果返回true，则触摸输入将被监听器消耗（系统执行关闭动作）。
+
+
+### (touchEvent: TouchEvent): Boolean
+
+触摸输入事件的回调函数。函数名由使用者定义，这里是函数调用时必须符合的格式，传入参数必须为TouchEvent类型，返回值为Boolean类型。
+
+**系统能力：**SystemCapability.MultimodalInput.Input.InputMonitor
+
+  **参数：**
+| 参数 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| touchEvent | [TouchEvent](../arkui-js/js-components-common-events.md) | 是 | 触摸输入事件回调函数，返回true表示输触事件被监听器消费，false表示输触事件未被监听器消费。 |
+
+  **返回值：**
+  | 类型 | 说明 | 
+| -------- | -------- |
+| Boolean | 返回true表示输触事件被监听器消费，false表示输触事件未被监听器消费。 | 
+
+  **示例：**
+
+```
+callback: function (value) {  //此处为(touchEvent:TouchEvent): Boolean 方法的实现
+    if (checkEvent(value)) {
+        //事件满足业务要求，事件被消费
+        return true;
+    } else {
+        //事件不满足业务要求，事件未被消费
+        return false;
+    }
+},
+testOff: function () {
+    console.info("InputMonitorJsTest---start---testOff");
+    inputMonitor.off(
+        "touch",
+        this.callback
+    );
+    console.info("InputMonitorJsTest---end---testOff");
+}
+```

zh-cn/overview-website.md

+# 了解OpenHarmony
+
+- [了解OpenHarmony开源项目](OpenHarmony-Overview_zh.md)
+- [术语](device-dev/glossary/glossary.md)
+- 版本说明
+  - OpenHarmony 3.x Releases
+    
+    -   [OpenHarmony v3.1 Beta (2021-12-31)](release-notes/OpenHarmony-v3.1-beta.md)
+    -   [OpenHarmony v3.0.1 LTS (2022-01-12)](release-notes/OpenHarmony-v3.0.1-LTS.md)
+    -   [OpenHarmony v3.0 LTS (2021-09-30)](release-notes/OpenHarmony-v3.0-LTS.md)
+    
+  - OpenHarmony 2.x Releases
+    
+    -   [OpenHarmony v2.2 beta2 (2021-08-04)](release-notes/OpenHarmony-v2.2-beta2.md)
+    -   [OpenHarmony 2.0 Canary (2021-06-01)](release-notes/OpenHarmony-2-0-Canary.md)
+    
+  - OpenHarmony 1.x Releases 
+    
+    -   [OpenHarmony v1.1.4 LTS (2022-02-11)](release-notes/OpenHarmony-v1-1-4-LTS.md)
+    -   [OpenHarmony v1.1.3 LTS (2021-09-30)](release-notes/OpenHarmony-v1-1-3-LTS.md)
+    -   [OpenHarmony v1.1.2 LTS (2021-08-04)](release-notes/OpenHarmony-v1.1.2-LTS.md)
+    -   [OpenHarmony 1.1.1 LTS (2021-06-22)](release-notes/OpenHarmony-1-1-1-LTS.md)
+    -   [OpenHarmony 1.1.0 LTS (2021-04-01)](release-notes/OpenHarmony-1-1-0-LTS.md)
+    -   [OpenHarmony 1.0 (2020-09-10)](release-notes/OpenHarmony-1-0.md)
+
+- 贡献
+  - [参与贡献](contribute/参与贡献.md)
+  - [行为准则](contribute/行为准则.md)
+  - [贡献代码](contribute/贡献代码.md)
+  - [贡献流程](contribute/贡献流程.md)
+  - [自测试验证](readme/测试子系统.md)
+  - [贡献文档](contribute/贡献文档.md)
+  - [写作规范](contribute/写作规范.md)
+  - [社区沟通与交流](contribute/社区沟通与交流.md)
+  - [FAQ](contribute/FAQ.md)
+    
\ No newline at end of file