!1358 Done! 1061 Update js-apis

Merge pull request !1358 from wusongqing/OpenHarmony-3.1-Beta

en/application-dev/reference/apis/Readme-EN.md

 # APIs
 
+- Ability Framework
+    -   [FeatureAbility Module](js-apis-featureAbility.md)
+    -   [ParticleAbility Module](js-apis-particleAbility.md)
+    -   [DataAbilityHelper Module](js-apis-dataAbilityHelper.md)
+    -   [DataUriUtils Module](js-apis-DataUriUtils.md)
+    -   [Context Module](js-apis-Context.md)
+    -   [CommonEvent Module](js-apis-commonEvent.md)
+    -   [Notification Module](js-apis-notification.md)
+-   Media
+    -   [Audio Management](js-apis-audio.md)
 -   [Console Logs](console-logs.md)
 -   [HiAppEvent](hiappevent.md)
 -   [Page Routing](page-routing.md)
 -   [Pop-up Window](pop-up-window.md)
 -   [Timer](timer.md)
--   [Audio Management](js-apis-audio.md)
 -   [Audio Playback](audio-playback.md)
 -   [Device Information](device-information.md)
 -   [System Attribute](system-attribute.md)

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

+# Context Module
+
+## Applicable Devices
+
+| API                                                          | Phone| Tablet| Smart TV| Wearable| Lite Wearable| SmartVision Device|
+| ------------------------------------------------------------ | ---- | ---- | ------ | -------- | -------------- | ------------ |
+| Context.getOrCreateLocalDir(callback: AsyncCallback\<string>) | Yes| Yes| Yes| Yes| No| No|
+| Context.getOrCreateLocalDir()                                | Yes| Yes| Yes| Yes| No| No|
+| Context.verifyPermission(permission: string, options: PermissionOptions, callback: AsyncCallback\<number>) | Yes| Yes| Yes| Yes| No| No|
+| Context.verifyPermission(permission: string, callback: AsyncCallback\<number>) | Yes| Yes| Yes| Yes| No| No|
+| Context.verifyPermission(permission: string, options?: PermissionOptions) | Yes| Yes| Yes| Yes| No| No|
+| Context.requestPermissionsFromUser(permissions: Array\<string>, requestCode: number, resultCallback: AsyncCallback\<PermissionRequestResult>) | Yes| Yes| Yes| Yes| No| No|
+| Context.getApplicationInfo(callback: AsyncCallback\<ApplicationInfo>) | Yes| Yes| Yes| Yes| No| No|
+| Context.getApplicationInfo()                                 | Yes| Yes| Yes| Yes| No| No|
+| Context.getBundleName(callback: AsyncCallback\<string>)      | Yes| Yes| Yes| Yes| No| No|
+| Context.getBundleName()                                      | Yes| Yes| Yes| Yes| No| No|
+| Context.getProcessInfo(callback: AsyncCallback\<ProcessInfo>) | Yes| Yes| Yes| Yes| No| No|
+| Context.getProcessInfo()                                     | Yes| Yes| Yes| Yes| No| No|
+| Context.getElementName(callback: AsyncCallback\<ElementName>) | Yes| Yes| Yes| Yes| No| No|
+| Context.getElementName()                                     | Yes| Yes| Yes| Yes| No| No|
+| Context.getProcessName(callback: AsyncCallback\<string>)     | Yes| Yes| Yes| Yes| No| No|
+| Context.getProcessName()                                     | Yes| Yes| Yes| Yes| No| No|
+| Context.getCallingBundle(callback: AsyncCallback\<string>)   | Yes| Yes| Yes| Yes| No| No|
+| Context.getCallingBundle()                                   | Yes| Yes| Yes| Yes| No| No|
+
+## Modules to Import
+
+```js
+import featureAbility from '@ohos.ability.featureAbility'
+import bundle from '@ohos.bundle'
+```
+
+The **Context** object is created in a **featureAbility** and returned through its **getContext()** method. Therefore, you must import the **@ohos.ability.featureAbility** package before using the Context module. An example is as follows:
+
+```js
+import featureAbility from '@ohos.ability.featureAbility'
+var context = featureAbility.getContext();
+context.getOrCreateLocalDir()
+```
+
+## Context.getOrCreateLocalDir(callback: AsyncCallback<string>)
+
+- Functionality
+
+  Obtains the local root directory of the application. If this method is called for the first time, a root directory is created. This method uses a callback to return the result.
+
+- Parameters
+
+
+| Name| Readable/Writable| Type| Mandatory| Description|
+| -------- | -------- | ---------------------- | ---- | ------------------------ |
+| callback | Read-only| AsyncCallback\<string> | Yes| Callback used to return the local root directory of the application.|
+
+- Return values
+
+  void
+
+- Example
+
+```js
+import featureAbility from '@ohos.ability.featureAbility'
+var context = featureAbility.getContext();
+context.getOrCreateLocalDir((err, data)=>{
+    console.info("data=" + data);
+})
+```
+
+
+
+## Context.getOrCreateLocalDir()
+
+- Functionality
+
+  Obtains the local root directory of the application. If this method is called for the first time, a root directory is created. This method uses a promise to return the result.
+
+- Parameters
+
+  None
+
+- Return values
+
+  | Type| Description|
+  | --------------- | -------------------- |
+  | Promise<string> | Promise used to return the local root directory of the application.|
+
+- Example
+
+```js
+import featureAbility from '@ohos.ability.featureAbility'
+var context = featureAbility.getContext();
+context.getOrCreateLocalDir().then((void) => {
+	console.info("==========================>getOrCreateLocalDirCallback=======================>");
+});
+```
+
+## PermissionOptions
+
+| Name| Readable/Writable| Type| Mandatory| Description|
+| ---- | -------- | ------ | ---- | ------ |
+| pid  | Read-only| number | No| PID.|
+| uid  | Read-only| number | No| UID.|
+
+## Context.verifyPermission(permission: string, options: PermissionOptions, callback: AsyncCallback<number>)
+
+- Functionality
+
+  Verifies whether a specific PID and UID have the given permission. This method uses a callback to return the result.
+
+- Parameters
+
+
+| Name| Readable/Writable| Type| Mandatory| Description|
+| ---------- | -------- | ----------------------------------------------- | ---- | ----------------------------------- |
+| permission | Read-only| string                                          | Yes| Name of the permission to verify.|
+| options    | Read-only| [PermissionOptions](#PermissionOptions)| Yes| Permission options.|
+| callback   | Read-only| AsyncCallback\<number>                          | Yes| Callback used to return the permission verification result. The value **0** indicates that the PID and UID have the given permission, and the value **-1** indicates that the PID and UID do not have the given permission.|
+
+- Return values
+
+  void
+
+- Example
+
+```js
+import featureAbility from '@ohos.ability.featureAbility'
+import bundle from '@ohos.bundle'
+var context = featureAbility.getContext();
+var datainfo = await bundle.getBundleInfo('com.context.test',1);
+context.verifyPermission("com.example.permission",datainfo.uid)
+
+```
+
+
+
+## Context.verifyPermission(permission: string, callback: AsyncCallback<number>)
+
+- Functionality
+
+  Verifies whether the current PID and UID have the given permission. This method uses a callback to return the result.
+
+- Parameters
+
+
+| Name| Readable/Writable| Type| Mandatory| Description|
+| ---------- | -------- | ---------------------- | ---- | ----------------------------------- |
+| permission | Read-only| string                 | Yes| Name of the permission to verify.|
+| callback   | Read-only| AsyncCallback\<number> | Yes| Callback used to return the permission verification result. The value **0** indicates that the PID and UID have the given permission, and the value **-1** indicates that the PID and UID do not have the given permission.|
+
+- Return values
+
+  void
+
+- Example
+
+```js
+import featureAbility from '@ohos.ability.featureAbility'
+var context = featureAbility.getContext();
+context.verifyPermission("com.example.permission")
+```
+
+
+
+## Context.verifyPermission(permission: string, options?: PermissionOptions)
+
+- Functionality
+
+  Verifies whether a specific PID and UID have the given permission. This method uses a promise to return the result.
+
+- Parameters
+
+
+| Name| Readable/Writable| Type| Mandatory| Description|
+| ---------- | -------- | ----------------------------------------------- | ---- | -------------- |
+| permission | Read-only| string                                          | Yes| Name of the permission to verify.|
+| options    | Read-only| [PermissionOptions](#PermissionOptions)| No| Permission options.|
+
+- Return values
+
+  | Type| Description|
+  | --------------- | ------------------------------------------------------------ |
+  | Promise<number> | Promise used to return the permission verification result. The value **0** indicates that the PID and UID have the given permission, and the value **-1** indicates that the PID and UID do not have the given permission.|
+
+- Example
+
+```js
+import featureAbility from '@ohos.ability.featureAbility'
+var context = featureAbility.getContext();
+var Permission = context.PermissionOptions(1,1);
+context.getOrCreateLocalDir('com.context.permission',Permission).then((void) => {
+	console.info("==========================>verifyPermissionCallback=======================>");
+});
+```
+
+## PermissionRequestResult
+
+| Name| Readable/Writable| Type| Mandatory| Description|
+| ----------- | -------- | -------------- | ---- | ------------------ |
+| requestCode | Read-only| number         | Yes| Request code passed.|
+| permissions | Read-only| Array\<string> | Yes| Permissions passed.|
+| authResults | Read-only| Array\<number> | Yes| Permission request result.|
+
+
+
+## Context.requestPermissionsFromUser(permissions: Array<string>, requestCode: number, resultCallback: AsyncCallback<[PermissionRequestResult](#PermissionRequestResult)>)
+
+- Functionality
+
+  Requests certain permissions from the system. This method uses a callback to return the result.
+
+- Parameters
+
+
+| Name| Readable/Writable| Type| Mandatory| Description|
+| -------------- | -------- | ------------------------------------------------------------ | ---- | --------------------------------------------- |
+| permissions    | Read-only| Array\<string>                                               | Yes| Permissions to request. This parameter cannot be **null**.|
+| requestCode    | Read-only| number                                                       | Yes| Request code to be passed to **PermissionRequestResult**.|
+| resultCallback | Read-only| AsyncCallback\<[PermissionRequestResult](#PermissionRequestResult)> | Yes| Permission request result.|
+- Return values
+
+  void
+
+- Example
+
+```js
+import featureAbility from '@ohos.ability.featureAbility'
+var context = featureAbility.getContext();
+context.getOrCreateLocalDir(    
+    ["com.example.permission1",
+     "com.example.permission2",
+     "com.example.permission3",
+     "com.example.permission4",
+     "com.example.permission5"],
+    1,
+)
+```
+
+
+
+## Context.getApplicationInfo(callback: AsyncCallback<ApplicationInfo>)
+
+- Functionality
+
+  Obtains information about the current application. This method uses a callback to return the result.
+
+- Parameters
+
+  | Name| Readable/Writable| Type| Mandatory| Description|
+  | -------- | -------- | ------------------------------- | ---- | ---------------------- |
+  | callback | Read-only| AsyncCallback\<ApplicationInfo> | Yes| Callback used to return the application information.|
+
+- Return values
+
+  void
+
+- Example
+
+```js
+import featureAbility from '@ohos.ability.featureAbility'
+var context = featureAbility.getContext();
+context.getApplicationInfo()
+```
+
+
+
+## Context.getApplicationInfo
+
+- Functionality
+
+  Obtains information about the current application. This method uses a promise to return the result.
+
+- Parameters
+
+  None
+
+- Return values
+
+  | Type| Description|
+  | ------------------------ | ------------------ |
+  | Promise<ApplicationInfo> | Promise used to return the application information.|
+
+- Example
+
+```js
+import featureAbility from '@ohos.ability.featureAbility'
+var context = featureAbility.getContext();
+context.getApplicationInfo().then((void) => {
+	console.info("==========================>getApplicationInfoCallback=======================>");
+});
+```
+
+
+
+##  Context.getBundleName(callback: AsyncCallback<string>)
+
+- Functionality
+
+  Obtains the bundle name of the current ability. This method uses a callback to return the result.
+
+- Parameters
+
+  | Name| Readable/Writable| Type| Mandatory| Description|
+  | -------- | -------- | ---------------------- | ---- | --------------------------- |
+  | callback | Read-only| AsyncCallback\<string> | Yes| Callback used to return the bundle name.|
+
+- Return values
+
+  void
+
+- Example
+
+```js
+import featureAbility from '@ohos.ability.featureAbility'
+var context = featureAbility.getContext();
+context.getBundleName()
+```
+
+
+
+## Context.getBundleName
+
+- Functionality
+
+  Obtains the bundle name of the current ability. This method uses a promise to return the result.
+
+- Parameters
+
+  None
+
+- Return values
+
+  | Type| Description|
+  | --------------- | ----------------------- |
+  | Promise<string> | Promise used to return the bundle name.|
+
+- Example
+
+```js
+import featureAbility from '@ohos.ability.featureAbility'
+var context = featureAbility.getContext();
+context.getBundleName().then((void) => {
+	console.info("==========================>getBundleNameCallback=======================>");
+});
+```
+
+
+
+##  Context.getProcessInfo(callback: AsyncCallback<ProcessInfo>)
+
+- Functionality
+
+  Obtains information about the current process, including the PID and process name. This method uses a callback to return the result.
+
+- Parameters
+
+  | Name| Readable/Writable| Type| Mandatory| Description|
+  | -------- | -------- | --------------------------- | ---- | ------------------ |
+  | callback | Read-only| AsyncCallback\<ProcessInfo> | Yes| Callback used to return the process information.|
+
+- Return values
+
+  void
+
+- Example
+
+```js
+import featureAbility from '@ohos.ability.featureAbility'
+var context = featureAbility.getContext();
+context.getProcessInfo()
+```
+
+
+
+## Context.getProcessInfo
+
+- Functionality
+
+  Obtains information about the current process, including the PID and process name. This method uses a promise to return the result.
+
+- Parameters
+
+  None
+
+- Return values
+
+  | Type| Description|
+  | -------------------- | -------------- |
+  | Promise<ProcessInfo> | Promise used to return the process information.|
+
+- Example
+
+```js
+import featureAbility from '@ohos.ability.featureAbility'
+var context = featureAbility.getContext();
+context.getProcessInfo().then((void) => {
+	console.info("==========================>getProcessInfoCallback=======================>");
+});
+```
+
+
+
+##  Context.getElementName(callback: AsyncCallback<ElementName>)
+
+- Functionality
+
+  Obtains the **ohos.bundle.ElementName** object of the current ability. This method is available only to Page abilities. It uses a callback to return the result.
+
+- Parameters
+
+  | Name| Readable/Writable| Type| Mandatory| Description|
+  | -------- | -------- | --------------------------- | ---- | -------------------------------------------- |
+  | callback | Read-only| AsyncCallback\<ElementName> | Yes| Callback used to return the **ohos.bundle.ElementName** object.|
+
+- Return values
+
+  void
+
+- Example
+
+```js
+import featureAbility from '@ohos.ability.featureAbility'
+var context = featureAbility.getContext();
+context.getElementName()
+```
+
+
+
+## Context.getElementName
+
+- Functionality
+
+  Obtains the **ohos.bundle.ElementName** object of the current ability. This method is available only to Page abilities. It uses a promise to return the result.
+
+- Parameters
+
+  None
+
+- Return values
+
+  | Type| Description|
+  | -------------------- | ---------------------------------------- |
+  | Promise<ElementName> | Promise used to return the **ohos.bundle.ElementName** object.|
+
+- Example
+
+```js
+import featureAbility from '@ohos.ability.featureAbility'
+var context = featureAbility.getContext();
+context.getElementName().then((void) => {
+	console.info("==========================>getElementNameCallback=======================>");
+});
+```
+
+##   **Context.getProcessName(callback: AsyncCallback<string>)**
+
+- Functionality
+
+  Obtains the name of the current process. This method uses a callback to return the result.
+
+- Parameters
+
+  | Name| Readable/Writable| Type| Mandatory| Description|
+  | -------- | -------- | ---------------------- | ---- | ------------------ |
+  | callback | Read-only| AsyncCallback\<string> | Yes| Callback used to return the process name.|
+
+- Return values
+
+  void
+
+- Example
+
+```js
+import featureAbility from '@ohos.ability.featureAbility'
+var context = featureAbility.getContext();
+context.getProcessName()
+```
+
+
+
+## Context.getProcessName
+
+- Functionality
+
+  Obtains the name of the current process. This method uses a promise to return the result.
+
+- Parameters
+
+  None
+
+- Return values
+
+  | Type| Description|
+  | --------------- | -------------- |
+  | Promise<string> | Promise used to return the process name.|
+
+- Example
+
+```js
+import featureAbility from '@ohos.ability.featureAbility'
+var context = featureAbility.getContext();
+context.getProcessName().then((void) => {
+	console.info("==========================>getProcessNameCallback=======================>");
+});
+```
+
+
+
+## Context.getCallingBundle(callback: AsyncCallback<string>)
+
+- Functionality
+
+  Obtains the bundle name of the calling ability. This method uses a callback to return the result.
+
+- Parameters
+
+  | Name| Readable/Writable| Type| Mandatory| Description|
+  | -------- | -------- | ---------------------- | ---- | ------------------------- |
+  | callback | Read-only| AsyncCallback\<string> | Yes| Callback used to return the bundle name.|
+
+- Return values
+
+  void
+
+- Example
+
+```js
+import featureAbility from '@ohos.ability.featureAbility'
+var context = featureAbility.getContext();
+context.getCallingBundle()
+```
+
+
+
+## Context.getCallingBundle
+
+- Functionality
+
+  Obtains the bundle name of the calling ability. This method uses a promise to return the result.
+
+- Parameters
+
+  None
+
+- Return values
+
+  | Type| Description|
+  | --------------- | ------------------------- |
+  | Promise<string> | Promise used to return the bundle name.|
+
+  
+
+- Example
+
+```js
+import featureAbility from '@ohos.ability.featureAbility'
+var context = featureAbility.getContext();
+context.getCallingBundle().then((void) => {
+	console.info("==========================>getCallingBundleCallback=======================>");
+});
+```

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

+# DataUriUtils Module
+
+## Modules to Import
+
+```js
+import dataUriUtils from '@ohos.ability.dataUriUtils';
+```
+
+## DataUriUtils.getId
+
+- Functionality
+
+  Obtains the ID attached to the end of a given URI.
+
+- Parameters
+
+
+| Name| Readable/Writable| Type| Mandatory| Description|
+| ---- | -------- | ------ | ---- | ------------------------- |
+| uri  | Read-only| string | Yes| URI object from which the ID is to be obtained.|
+
+- Return values
+
+  Returns the ID obtained from the URI object.
+
+- Example
+
+```js
+import dataUriUtils from '@ohos.ability.datauriutils'
+dataUriUtils.getIdSync("com.example.dataUriUtils/1221")
+```
+
+
+
+## DataUriUtils.attachId
+
+- Functionality
+
+  Attaches an ID to the end of a given URI.
+
+- Parameters
+
+
+| Name| Readable/Writable| Type| Mandatory| Description|
+| ---- | -------- | ------ | ---- | ------------------------- |
+| uri  | Read-only| string | Yes| URI object to which an ID is to be attached.|
+| id   | Read-only| number | Yes| ID to be attached.|
+
+- Return values
+
+  Returns the URI object with the ID attached.
+
+- Example
+
+```js
+import dataUriUtils from '@ohos.ability.datauriutils'
+var idint = 1122;
+dataUriUtils.attachId(
+    "com.example.dataUriUtils"
+	idint,
+)
+```
+
+
+
+## DataUriUtils.deleteId
+
+- Functionality
+
+  Deletes the ID from the end of a given URI.
+
+- Parameters
+
+  | Name| Readable/Writable| Type| Mandatory| Description|
+  | ---- | -------- | ------ | ---- | ------------------------- |
+  | uri  | Read-only| string | Yes| URI object from which the ID is to be deleted.|
+
+- Return values
+
+  Returns the URI object with the ID deleted.
+
+- Example
+
+```js
+import dataUriUtils from '@ohos.ability.datauriutils'
+dataUriUtils.deleteId("com.example.dataUriUtils/1221")
+```
+
+
+
+## DataUriUtils.updateId
+
+- Functionality
+
+  Updates the ID in a given URI.
+
+- Parameters
+
+  | Name| Readable/Writable| Type| Mandatory| Description|
+  | ---- | -------- | ------ | ---- | ------------------- |
+  | uri  | Read-only| string | Yes| URI object to be updated.|
+  | id   | Read-only| number | Yes| New ID.|
+
+- Return values
+
+  Returns the URI object with the new ID.
+
+- Example
+
+```js
+import dataUriUtils from '@ohos.ability.datauriutils'
+var idint = 1122;
+dataUriUtils.updateId(
+    "com.example.dataUriUtils"
+	idint,
+)
+```

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

+# ParticleAbility Module
+
+## Applicable Devices
+
+| API                                                          | Phone| Tablet| Smart TV| Wearable| Lite Wearable| SmartVision Device|
+| ------------------------------------------------------------ | ---- | ---- | ------ | -------- | -------------- | ------------ |
+| particleAbility.startAbility(parameter: StartAbilityParameter, callback: AsyncCallback\<void>: void | Yes| Yes| Yes| Yes| No| No|
+| particleAbility.startAbility(parameter: StartAbilityParameter): Promise\<number> | Yes| Yes| Yes| Yes| No| No|
+| particleAbility.terminateSelf(callback: AsyncCallback\<void>): void | Yes| Yes| Yes| Yes| No| No|
+| particleAbility.terminateSelf(): Promise\<void>              | Yes| Yes| Yes| Yes| No| No|
+| particleAbility.acquireDataAbilityHelper(uri: string): DataAbilityHelper | Yes| Yes| Yes| Yes| No| No|
+| particleAbility.connectAbility(request: Want, options:ConnectOptions): number | Yes| Yes| Yes| Yes| No| No|
+| particleAbility.disconnectAbility(connection: number, callback:AsyncCallback\<void>): void | Yes| Yes| Yes| Yes| No| No|
+| particleAbility.disconnectAbility(connection: number): Promise\<void> | Yes| Yes| Yes| Yes| No| No|
+
+## Constraints
+
+The ParticleAbility module is used to perform operations on abilities of the Data and Service types.
+
+## Modules to Import
+
+```js
+import particleAbility from '@ohos.ability.particleAbility'
+```
+
+## particleAbility.startAbility(parameter: StartAbilityParameter, callback: AsyncCallback\<void>: void
+
+- Functionality
+
+  Starts a Service ability. This method uses a callback to return the result.
+
+- Parameters
+
+
+| Name| Readable/Writable| Type| Mandatory| Description|
+| --------- | -------- | ------------------------------------------------------- | ---- | ----------------- |
+| parameter | Read-only| [StartAbilityParameter](#StartAbilityParameter)| Yes| Ability to start.|
+| callback  | Read-only| AsyncCallback\<void>                                    | Yes| Callback used to return the result.|
+
+- Return values
+
+  void
+
+- Example
+
+```js
+import particleAbility from '@ohos.ability.particleAbility'
+particleAbility.startAbility(
+	{
+        want:
+        {
+            action: "action.system.home",
+            entities: ["entity.system.home"],
+            type: "MIMETYPE",
+            flags: FLAG_AUTH_READ_URI_PERMISSION;
+            deviceId: "",
+            bundleName: "com.example.Data",
+            abilityName: "com.example.Data.MainAbility",
+            uri:""
+        },
+    },
+    (error, result) => {
+		console.log('particleAbility startAbility errCode:' + error + 'result:' + result)
+    },
+)
+```
+
+
+
+## particleAbility.startAbility(parameter: StartAbilityParameter): Promise\<number>
+
+- Functionality
+Starts a Service ability. This method uses a promise to return the result.
+
+- Parameters
+
+
+| Name| Readable/Writable| Type| Mandatory| Description|
+| --------- | -------- | ------------------------------------------------------- | ---- | ----------------- |
+| parameter | Read-only| [StartAbilityParameter](#StartAbilityParameter)| Yes| Ability to start.|
+- Return values
+
+  Promise\<void>
+
+- Example
+
+```js
+import particleAbility from '@ohos.ability.particleAbility'
+particleAbility.startAbility(
+	{
+        want:
+        {
+            action: "action.system.home",
+            entities: ["entity.system.home"],
+            type: "MIMETYPE",
+            flags: FLAG_AUTH_READ_URI_PERMISSION;
+            deviceId: "",
+            bundleName: "com.example.Data",
+            abilityName: "com.example.Data.MainAbility",
+            uri:""
+        },
+    },
+).then((void) => {
+    console.info("particleAbility startAbility");
+});
+```
+
+
+
+## particleAbility.terminateSelf(callback: AsyncCallback\<void>): void
+
+- Functionality
+
+  Terminates this Service ability. This method uses a callback to return the result.
+
+- Parameters
+
+| Name| Readable/Writable| Type| Mandatory| Description|
+| -------- | -------- | -------------------- | ---- | -------------------- |
+| callback | Read-only| AsyncCallback\<void> | Yes| Callback used to return the result.|
+
+- Return values
+
+  void
+
+- Example
+
+```js
+import particleAbility from '@ohos.ability.particleAbility'
+particleAbility.terminateSelf(
+    (error, result) => {
+		console.log('particleAbility terminateSelf errCode:' + error + 'result:' + result)
+    }
+)
+```
+
+
+
+## particleAbility.terminateSelf(): Promise\<void>
+
+- Functionality
+
+  Terminates this Service ability. This method uses a promise to return the result.
+
+- Return values
+
+  Promise\<void>
+
+- Example
+
+```js
+import particleAbility from '@ohos.ability.particleAbility'
+particleAbility.terminateSelf().then((void) => {
+	console.info("particleAbility terminateSelf");
+});
+```
+
+
+
+## particleAbility.acquireDataAbilityHelper(uri: string): DataAbilityHelper
+
+- Functionality
+
+  Obtains a **dataAbilityHelper** object.
+
+- Parameters
+
+| Name| Readable/Writable| Type| Mandatory| Description|
+| :--- | -------- | ------ | ---- | ---------------------- |
+| uri  | Read-only| string | Yes| URI of the file to open.|
+
+- Return values
+
+| Type| Description|
+| ----------------- | ------------------------------------------ |
+| DataAbilityHelper | A utility class used to help other abilities access a Data ability.|
+
+- Example
+
+```js
+import particleAbility from '@ohos.ability.particleAbility'     
+var uri = "";
+particleAbility.acquireDataAbilityHelper(uri)
+```
+
+## particleAbility.connectAbility(request: Want, options:ConnectOptions): number
+
+* Functionality
+
+  Connects this ability to a specific Service ability. This method uses a callback to return the result.
+
+* Parameters
+
+| Name| Readable/Writable| Type| Mandatory| Description|
+| ------- | -------- | -------------- | ---- | -------------------------- |
+| request | Read-only| Want           | Yes| Service ability to connect.|
+| options | Read-only| ConnectOptions | Yes| Callback used to return the result.|
+
+- ConnectOptions
+
+| Name| Readable/Writable| Type| Mandatory| Description|
+| ------------ | -------- | -------- | ---- | ---------------------------------- |
+| onConnect    | Read-only| function | Yes| Callback invoked when the connection is set up.|
+| onDisconnect | Read-only| function | Yes| Callback invoked when the connection is interrupted.|
+| onFailed     | Read-only| function | Yes| Callback invoked when the connection fails.|
+
+* Return values
+
+  Returns the unique identifier of the connection.
+
+* Example
+
+```javascript
+import particleAbility from '@ohos.ability.particleAbility'
+function onConnectCallback(element, remote){
+    console.log('ConnectAbility onConnect remote is proxy:' + (remote instanceof rpc.RemoteProxy));
+}
+function onDisconnectCallback(element){
+    console.log('ConnectAbility onDisconnect element.deviceId : ' + element.deviceId)
+}
+function onFailedCallback(code){
+    console.log('particleAbilityTest ConnectAbility onFailed errCode : ' + code)
+}
+var connId = particleAbility.connectAbility(
+    {
+        bundleName: "com.ix.ServiceAbility",
+        abilityName: "com.ix.ServiceAbility.ServiceAbilityA",
+    },
+    {
+        onConnect: onConnectCallback,
+        onDisconnect: onDisconnectCallback,
+        onFailed: onFailedCallback,
+    },
+);
+```
+
+## particleAbility.disconnectAbility(connection: number, callback:AsyncCallback\<void>): void
+
+* Functionality
+
+  Disconnects this ability from a specific Service ability. This method uses a callback to return the result.
+
+* Parameters
+
+| Name| Readable/Writable| Type| Mandatory| Description|
+| ---------- | -------- | ------------- | ---- | ------------------------------ |
+| connection | Read-only| number        | Yes| ID of the Service ability to disconnect.|
+| callback   | Read-only| AsyncCallback\<void> | Yes| Callback used to return the result.|
+
+* Return values
+
+  void
+
+* Example
+
+```javascript
+import particleAbility from '@ohos.ability.particleAbility'
+function onConnectCallback(element, remote){
+    console.log('ConnectAbility onConnect remote is proxy:' + (remote instanceof rpc.RemoteProxy));
+}
+function onDisconnectCallback(element){
+    console.log('ConnectAbility onDisconnect element.deviceId : ' + element.deviceId)
+}
+function onFailedCallback(code){
+    console.log('particleAbilityTest ConnectAbility onFailed errCode : ' + code)
+}
+var connId = particleAbility.connectAbility(
+    {
+        bundleName: "com.ix.ServiceAbility",
+        abilityName: "com.ix.ServiceAbility.ServiceAbilityA",
+    },
+    {
+        onConnect: onConnectCallback,
+        onDisconnect: onDisconnectCallback,
+        onFailed: onFailedCallback,
+    },
+);
+var result = particleAbility.disconnectAbility(connId,
+    (error,data) => {
+        console.log('particleAbilityTest DisConnectAbility result errCode : ' + error.code + " data: " + data)
+    },
+);
+```
+
+## particleAbility.disconnectAbility(connection: number): Promise\<void>
+
+* Functionality
+
+  Disconnects this ability from a specific Service ability. This method uses a promise to return the result.
+
+* Parameters
+
+| Name| Readable/Writable| Type| Mandatory| Description|
+| ---------- | -------- | ------ | ---- | ------------------------------ |
+| connection | Read-only| number | Yes| ID of the Service ability to disconnect.|
+
+* Return values
+
+  Promise\<void>
+
+* Example
+
+```javascript
+import particleAbility from '@ohos.ability.particleAbility'
+function onConnectCallback(element, remote){
+    console.log('ConnectAbility onConnect remote is proxy:' + (remote instanceof rpc.RemoteProxy));
+}
+function onDisconnectCallback(element){
+    console.log('ConnectAbility onDisconnect element.deviceId : ' + element.deviceId)
+}
+function onFailedCallback(code){
+    console.log('particleAbilityTest ConnectAbility onFailed errCode : ' + code)
+}
+var connId = particleAbility.connectAbility(
+    {
+        bundleName: "com.ix.ServiceAbility",
+        abilityName: "com.ix.ServiceAbility.ServiceAbilityA",
+    },
+    {
+        onConnect: onConnectCallback,
+        onDisconnect: onDisconnectCallback,
+        onFailed: onFailedCallback,
+    },
+);
+var result = particleAbility.disconnectAbility(connId).then((void) => {
+	console.info("particleAbilityTest disconnectAbility");
+});
+```
+
+## StartAbilityParameter
+
+| Name| Readable/Writable| Type| Mandatory| Description|
+| ------------------- | -------- | --------------------- | ---- | ------------------------------------------------------------ |
+| want                | Read-only| [Want](#Want)| Yes| Information about the ability to start.|
+| abilityStartSetting | Read-only| {[key: string]: any}  | No| Special attribute of the ability to start. This attribute can be passed in the method call.|
+
+## Want
+
+| Name| Readable/Writable| Type| Mandatory| Description|
+| ----------- | -------- | -------------------- | ---- | ------------------------------------------------------------ |
+| deviceId    | Read-only| string               | No| ID of the device running the ability to start.|
+| bundleName  | Read-only| string               | No| Bundle name of the ability to start. If both **bundleName** and **abilityName** are specified in a **Want** object, the **Want** object can directly match the specified ability.|
+| abilityName | Read-only| string               | No| Name of the ability to start. If both **bundleName** and **abilityName** are specified in a **Want** object, the **Want** object can directly match the specified ability.|
+| uri         | Read-only| string               | No| URI information to match. If **uri** is specified in a **Want** object, the **Want** object will match the specified URI information, including **scheme**, **schemeSpecificPart**, **authority**, and **path**.|
+| type        | Read-only| string               | No| MIME type, for example, **text/plain** or **image/***.|
+| flags       | Read-only| number               | No| How the **Want** object will be handled. By default, numbers are passed in. For details, see [flags](#flags).|
+| action      | Read-only| string               | No| Action option.|
+| parameters  | Read-only| {[key: string]: any} | No| List of parameters in the **Want** object.|
+| entities    | Read-only| Array\<string>       | No| List of entities.|
+
+## flags
+
+| Name| Value| Description|
+| ------------------------------------ | ---------- | ------------------------------------------------------------ |
+| FLAG_AUTH_READ_URI_PERMISSION        | 0x00000001 | Indicates the permission to read the URI.|
+| FLAG_AUTH_WRITE_URI_PERMISSION       | 0x00000002 | Indicates the permission to write the URI.|
+| FLAG_ABILITY_FORWARD_RESULT          | 0x00000004 | Returns the result to the ability.|
+| FLAG_ABILITY_CONTINUATION            | 0x00000008 | Indicates whether the ability on the local device can be migrated to a remote device.|
+| FLAG_NOT_OHOS_COMPONENT              | 0x00000010 | Indicates that a component does not belong to OHOS.|
+| FLAG_ABILITY_FORM_ENABLED            | 0x00000020 | Indicates whether to enable an ability.|
+| FLAG_AUTH_PERSISTABLE_URI_PERMISSION | 0x00000040 | Indicates the permission to make the URI persistent.|
+| FLAG_AUTH_PREFIX_URI_PERMISSION      | 0x00000080 | Indicates the permission to verify URIs by prefix matching.|
+| FLAG_ABILITYSLICE_MULTI_DEVICE       | 0x00000100 | Supports cross-device startup in a distributed scheduler.|
+| FLAG_START_FOREGROUND_ABILITY        | 0x00000200 | Indicates that the Service ability is started regardless of whether the host application has been started.|
+| FLAG_ABILITY_CONTINUATION_REVERSIBLE | 0x00000400 | Indicates that the migration is reversible.|
+| FLAG_INSTALL_ON_DEMAND               | 0x00000800 | Indicates that the specific ability will be installed if it has not been installed.|
+| FLAG_INSTALL_WITH_BACKGROUND_MODE    | 0x80000000 | Indicates that the specific ability will be installed in the background if it has not been installed.|
+| FLAG_ABILITY_CLEAR_MISSION           | 0x00008000 | Clears other operation missions. This flag can be set for the **Want** object passed to **ohos.app.Context#startAbility** and must be used together with **flag_ABILITY_NEW_MISSION**.|
+| FLAG_ABILITY_NEW_MISSION             | 0x10000000 | Creates a mission on the historical mission stack.|
+| FLAG_ABILITY_MISSION_TOP             | 0x20000000 | Starts the mission on the top of the existing mission stack; creates an ability instance if no mission exists.|
+
+## AbilityStartSetting
+
+Defines special attributes of an ability, for example, **featureAbility.AbilityStartSetting.BOUNDS_KEY**.
+
+The **AbilityStartSetting** attribute is an object defined as [key: string]: any. The key is a type of **AbilityStartSetting**, and the value is a type of **AbilityWindowConfiguration**.
+
+| Name| Value| Description|
+| --------------- | --------------- | -------------------------- |
+| BOUNDS_KEY      | "abilityBounds" | Ability window size.|
+| WINDOW_MODE_KEY | "windowMode"    | Ability window display mode.|
+| DISPLAY_ID_KEY  | "displayId"     | Display device ID.|
+
+## AbilityWindowConfiguration
+
+Defines the window display modes of a Page ability, for example, **featureAbility.AbilityWindowConfiguration.WINDOW_MODE_UNDEFINED**.
+
+| Name| Value| Description|
+| --------------------------- | ---- | ---------- |
+| WINDOW_MODE_UNDEFINED       | 0    | The Page ability is in an undefined window display mode.|
+| WINDOW_MODE_FULLSCREEN      | 1    | The Page ability is in full screen mode.|
+| WINDOW_MODE_SPLIT_PRIMARY   | 100  | The Page ability is displayed in the primary window when it is in split-screen mode.|
+| WINDOW_MODE_SPLIT_SECONDARY | 101  | The Page ability is displayed in the secondary window when it is in split-screen mode.|
+| WINDOW_MODE_FLOATING        | 102  | The Page ability is displayed in floating window mode.|