diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-serviceExtensionContext.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-serviceExtensionContext.md index 49d54c0f1253829cd0f39d805b3037824e5162b3..778bc053cd801ed6b0a00112c0b524d0882c601d 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-serviceExtensionContext.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-serviceExtensionContext.md @@ -1363,7 +1363,9 @@ startAbilityByCallWithAccount(want: Want, accountId: number): Promise<Caller& 使用规则: - 跨用户场景下,Call调用目标Ability时,调用方应用需同时申请`ohos.permission.ABILITY_BACKGROUND_COMMUNICATION`与`ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS`权限 - - 其他场景下,startAbilityByCallWithAccount接口使用规则与[startAbilityByCall使用规则保持一致](#serviceextensioncontextstartabilitybycall) + - 调用方应用位于后台时,使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 跨应用场景下,目标Ability的exported属性若配置为false,调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 同设备与跨设备场景下,该接口的使用规则存在差异,详见:[组件启动规则(Stage模型)](../../application-models/component-startup-rules.md) **系统能力**:SystemCapability.Ability.AbilityRuntime.Core @@ -1373,7 +1375,7 @@ startAbilityByCallWithAccount(want: Want, accountId: number): Promise<Caller& | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| want | [Want](js-apis-application-want.md) | 是 | 传入需要启动的Ability的信息,包含内容与[startAbilityByCall使用信息保持一致](#serviceextensioncontextstartabilitybycall)。 | +| want | [Want](js-apis-application-want.md) | 是 | 传入需要启动的Ability的信息,包含abilityName、moduleName、bundleName、deviceId(可选)、parameters(可选),其中deviceId缺省或为空表示启动本地Ability,parameters缺省或为空表示后台启动Ability。 | | accountId | number | 是 | 系统帐号的帐号ID,-1表示当前活动用户,详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getosaccountlocalidfromprocess)。 | **返回值:** @@ -1412,6 +1414,10 @@ startAbilityByCallWithAccount(want: Want, accountId: number): Promise<Caller& moduleName: 'entry', abilityName: 'EntryAbility' deviceId: '' + parameters: { + // 'ohos.aafwk.param.callAbilityToForeground' 值设置为true时为前台启动, 设置false或不设置为后台启动 + 'ohos.aafwk.param.callAbilityToForeground': true + } }; try { 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 1884e42358662bfbecc49af5fb3af2a182215089..d083c6e27a5e537408d5e32532a912cc59d96c8b 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 @@ -2300,7 +2300,9 @@ startAbilityByCallWithAccount(want: Want, accountId: number): Promise<Caller& 使用规则: - 跨用户场景下,Call调用目标Ability时,调用方应用需同时申请`ohos.permission.ABILITY_BACKGROUND_COMMUNICATION`与`ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS`权限 - - 其他场景下,startAbilityByCallWithAccount接口使用规则与[startAbilityByCall使用规则保持一致](#uiabilitycontextstartabilitybycall) + - 调用方应用位于后台时,使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 + - 跨应用场景下,目标Ability的exported属性若配置为false,调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 + - 同设备与跨设备场景下,该接口的使用规则存在差异,详见:[组件启动规则(Stage模型)](../../application-models/component-startup-rules.md) **系统能力**:SystemCapability.Ability.AbilityRuntime.Core @@ -2310,7 +2312,7 @@ startAbilityByCallWithAccount(want: Want, accountId: number): Promise<Caller& | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| want | [Want](js-apis-application-want.md) | 是 | 传入需要启动的Ability的信息,包含内容与[startAbilityByCall使用信息保持一致](#uiabilitycontextstartabilitybycall)。 | +| want | [Want](js-apis-application-want.md) | 是 | 传入需要启动的Ability的信息,包含abilityName、moduleName、bundleName、deviceId(可选)、parameters(可选),其中deviceId缺省或为空表示启动本地Ability,parameters缺省或为空表示后台启动Ability。 | | accountId | number | 是 | 系统帐号的帐号ID,-1表示当前活动用户,详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getosaccountlocalidfromprocess)。 | **返回值:** @@ -2349,6 +2351,10 @@ startAbilityByCallWithAccount(want: Want, accountId: number): Promise<Caller& moduleName: 'entry', abilityName: 'EntryAbility' deviceId: '' + parameters: { + // 'ohos.aafwk.param.callAbilityToForeground' 值设置为true时为前台启动, 设置false或不设置为后台启动 + 'ohos.aafwk.param.callAbilityToForeground': true + } }; try {