From e899a321072511e2f8bdf557c0ec7dc640f7ae4e Mon Sep 17 00:00:00 2001 From: "zhangyafei.echo" Date: Fri, 23 Dec 2022 17:20:24 +0800 Subject: [PATCH] Description:Modify description of js-apis-inner-application-UIAbilityContext.md Sig:SIG_ApplicationFramework Feature or BugFix: Feature Binary Source: No Signed-off-by: zhangyafei.echo Change-Id: I07b843f4ec14bf92358b34cbfd80beba4b82bbdf --- ...apis-inner-application-uiAbilityContext.md | 99 ++++--------------- 1 file changed, 17 insertions(+), 82 deletions(-) diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-uiAbilityContext.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-uiAbilityContext.md index feaa175b8c..7bd94a2623 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-uiAbilityContext.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-uiAbilityContext.md @@ -447,7 +447,7 @@ startAbilityForResult(want: Want, options?: StartOptions): Promise<AbilityRes startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncCallback\): void; -启动一个Ability并在该Ability帐号销毁时返回执行结果（callback形式）。 +启动一个Ability并在该Ability销毁时返回执行结果（callback形式）。 **需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS @@ -621,7 +621,7 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartO | 类型 | 说明 | | -------- | -------- | -| Promise<[AbilityResult](js-apis-inner-ability-abilityResult.md)> | Ability被销毁时的回调函数，包含Ability结果。 | +| Promise<[AbilityResult](js-apis-inner-ability-abilityResult.md)> | Ability被销毁时的回调函数，包含AbilityResult参数。 | **错误码：** @@ -693,8 +693,8 @@ startServiceExtensionAbility(want: Want, callback: AsyncCallback\): void; | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| want | [Want](js-apis-application-want.md) | 是 | 启动Ability的want信息。 | -| callback | AsyncCallback\ | 是 | 启动Ability的回调函数。 | +| want | [Want](js-apis-application-want.md) | 是 | 启动ServiceExtensionAbility的want信息。 | +| callback | AsyncCallback\ | 是 | 启动ServiceExtensionAbility的回调函数。 | **错误码：** @@ -816,9 +816,9 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| want | [Want](js-apis-application-want.md) | 是 | 启动Ability的want信息。 | +| want | [Want](js-apis-application-want.md) | 是 | 启动ServiceExtensionAbility的want信息。 | | accountId | number | 是 | 系统帐号的帐号ID，详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getCreatedOsAccountsCount)。 | -| callback | AsyncCallback\ | 是 | 启动Ability的回调函数。 | +| callback | AsyncCallback\ | 是 | 启动ServiceExtensionAbility的回调函数。 | **错误码：** @@ -940,8 +940,8 @@ stopServiceExtensionAbility(want: Want, callback: AsyncCallback\): void; | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| want | [Want](js-apis-application-want.md) | 是 | 启动Ability的want信息。 | -| callback | AsyncCallback\ | 是 | 启动Ability的回调函数。 | +| want | [Want](js-apis-application-want.md) | 是 | 停止ServiceExtensionAbility的want信息。 | +| callback | AsyncCallback\ | 是 | 停止ServiceExtensionAbility的回调函数。 | **错误码：** @@ -1225,7 +1225,7 @@ terminateSelf(): Promise<void>; | 类型 | 说明 | | -------- | -------- | -| Promise<void> | 返回一个Promise，包含接口的结果。 | +| Promise<void> | 停止Ability自身的回调函数。 | **错误码：** @@ -1397,8 +1397,8 @@ connectServiceExtensionAbility(want: Want, options: ConnectOptions): number; | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| want | [Want](js-apis-application-want.md) | 是 | 启动Ability的want信息。 | -| options | [ConnectOptions](js-apis-inner-ability-connectOptions.md) | 否 | 远端对象实例。 | +| want | [Want](js-apis-application-want.md) | 是 | 连接ServiceExtensionAbility的want信息。 | +| options | [ConnectOptions](js-apis-inner-ability-connectOptions.md) | 是 | 与ServiceExtensionAbility建立连接后回调函数的实例。 | **返回值：** @@ -1461,7 +1461,7 @@ connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options | -------- | -------- | -------- | -------- | | want | [Want](js-apis-application-want.md) | 是 | 启动Ability的want信息。 | | accountId | number | 是 | 系统帐号的帐号ID，详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getCreatedOsAccountsCount)。 | -| options | [ConnectOptions](js-apis-inner-ability-connectOptions.md) | 否 | 远端对象实例。 | +| options | [ConnectOptions](js-apis-inner-ability-connectOptions.md) | 是 | 与ServiceExtensionAbility建立连接后回调函数的实例。。 | **返回值：** @@ -1579,7 +1579,7 @@ disconnectServiceExtensionAbility(connection: number, callback:AsyncCallback\ | 是 | 表示指定的回调方法。 | +| callback | AsyncCallback\ | 是 | callback形式返回断开连接的结果。 | **错误码：** @@ -1707,7 +1707,7 @@ startAbilityByCall(want: Want): Promise<Caller>; startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\): void; -根据accountId启动Ability（callback形式）。 +根据want和accountId启动Ability（callback形式）。 **需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS @@ -1781,7 +1781,7 @@ startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\< startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, callback: AsyncCallback\): void; -根据accountId及startOptions启动Ability（callback形式）。 +根据want、accountId及startOptions启动Ability（callback形式）。 **需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS @@ -1795,7 +1795,7 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca | -------- | -------- | -------- | -------- | | want | [Want](js-apis-application-want.md) | 是 | 启动Ability的want信息。 | | accountId | number | 是 | 系统帐号的帐号ID，详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getCreatedOsAccountsCount)。| -| options | [StartOptions](js-apis-app-ability-startOptions.md) | 否 | 启动Ability所携带的参数。 | +| options | [StartOptions](js-apis-app-ability-startOptions.md) | 是 | 启动Ability所携带的参数。 | | callback | AsyncCallback\ | 是 | 启动Ability的回调函数。 | **错误码：** @@ -1859,7 +1859,7 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): Promise\; -根据accountId和startOptions启动Ability（Promise形式）。 +根据want、accountId和startOptions启动Ability（Promise形式）。 **需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS @@ -1931,71 +1931,6 @@ startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): } ``` -## UIAbilityContext.requestPermissionsFromUser - -> **说明：** -> - 该接口自API version 9已废弃。 - -requestPermissionsFromUser(permissions: Array<string>, requestCallback: AsyncCallback<PermissionRequestResult>) : void; - -拉起弹窗请求用户授权（callback形式）。 - -**系统能力**：SystemCapability.Ability.AbilityRuntime.Core - -**参数：** - -| 参数名 | 类型 | 必填 | 说明 | -| -------- | -------- | -------- | -------- | -| permissions | Array<string> | 是 | 权限列表。 | -| callback | AsyncCallback<[PermissionRequestResult](js-apis-inner-application-permissionRequestResult.md)> | 是 | 回调函数，返回接口调用是否成功的结果。 | - -**示例：** - - ```ts - var permissions=['com.example.permission'] - this.context.requestPermissionsFromUser(permissions,(result) => { - console.log('requestPermissionsFromUserresult:' + JSON.stringify(result)); - }); - - ``` - - -## UIAbilityContext.requestPermissionsFromUser - -> **说明：** -> - 该接口自API version 9已废弃。 - -requestPermissionsFromUser(permissions: Array<string>) : Promise<PermissionRequestResult>; - -拉起弹窗请求用户授权（promise形式）。 - -**系统能力**：SystemCapability.Ability.AbilityRuntime.Core - -**参数：** - -| 参数名 | 类型 | 必填 | 说明 | -| -------- | -------- | -------- | -------- | -| permissions | Array<string> | 是 | 权限列表。 | - -**返回值：** - -| 类型 | 说明 | -| -------- | -------- | -| Promise<[PermissionRequestResult](js-apis-inner-application-permissionRequestResult.md)> | 返回一个Promise，包含接口的结果。 | - -**示例：** - - ```ts - var permissions=['com.example.permission'] - this.context.requestPermissionsFromUser(permissions).then((data) => { - console.log('success:' + JSON.stringify(data)); - }).catch((error) => { - console.log('failed:' + JSON.stringify(error)); - }); - - ``` - - ## UIAbilityContext.setMissionLabel setMissionLabel(label: string, callback:AsyncCallback<void>): void; -- GitLab