From 60f16c963005c63e73c190e4d8ec0575e6b33097 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=9C=B1=E5=A4=A9=E6=80=A1?= Date: Tue, 18 Oct 2022 08:14:43 +0000 Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E6=94=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: 朱天怡 --- .../apis/js-apis-backgroundTaskManager.md | 80 ++++--------------- 1 file changed, 14 insertions(+), 66 deletions(-) diff --git a/zh-cn/application-dev/reference/apis/js-apis-backgroundTaskManager.md b/zh-cn/application-dev/reference/apis/js-apis-backgroundTaskManager.md index 957892c626..d6a6419ea0 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-backgroundTaskManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-backgroundTaskManager.md @@ -23,7 +23,7 @@ import backgroundTaskManager from '@ohos.backgroundTaskManager'; ``` -## backgroundTaskManager.requestSuspendDelay7+(deprecated) +## backgroundTaskManager.requestSuspendDelay7+ requestSuspendDelay(reason: string, callback: Callback<void>): DelaySuspendInfo @@ -31,10 +31,6 @@ requestSuspendDelay(reason: string, callback: Callback<void>): DelaySuspen 延迟挂起时间一般情况下默认值为180000毫秒，低电量（依据系统低电量广播）时默认值为60000毫秒。 -> **说明：** 从API version 9开始废弃，建议使用[backgroundTaskManager.requestSuspendDelay](./js-apis-resourceschedule-backgroundTaskManager.md/#backgroundtaskmanagerrequestsuspenddelay9) -> -> 从 API version 7开始支持。 - **系统能力:** SystemCapability.ResourceSchedule.BackgroundTaskManager.TransientTask **参数**： @@ -65,16 +61,12 @@ requestSuspendDelay(reason: string, callback: Callback<void>): DelaySuspen ``` -## backgroundTaskManager.getRemainingDelayTime7+(deprecated) +## backgroundTaskManager.getRemainingDelayTime7+ getRemainingDelayTime(requestId: number, callback: AsyncCallback<number>): void 获取应用程序进入挂起状态前的剩余时间，使用callback形式返回。 -> **说明：** 从API version 9开始废弃，建议使用[backgroundTaskManager.getRemainingDelayTime](./js-apis-resourceschedule-backgroundTaskManager.md/#backgroundtaskmanagergetremainingdelaytimecallback9) -> -> 从 API version 7开始支持。 - **系统能力:** SystemCapability.ResourceSchedule.BackgroundTaskManager.TransientTask **参数**： @@ -99,16 +91,12 @@ getRemainingDelayTime(requestId: number, callback: AsyncCallback<number>): ``` -## backgroundTaskManager.getRemainingDelayTime7+(deprecated) +## backgroundTaskManager.getRemainingDelayTime7+ getRemainingDelayTime(requestId: number): Promise<number> 获取应用程序进入挂起状态前的剩余时间，使用Promise形式返回。 -> **说明：** 从API version 9开始废弃，建议使用[backgroundTaskManager.getRemainingDelayTime](./js-apis-resourceschedule-backgroundTaskManager.md/#backgroundtaskmanagergetremainingdelaytimepromise9) -> -> 从 API version 7开始支持。 - **系统能力:** SystemCapability.ResourceSchedule.BackgroundTaskManager.TransientTask **参数**： @@ -132,16 +120,12 @@ getRemainingDelayTime(requestId: number): Promise<number> ``` -## backgroundTaskManager.cancelSuspendDelay7+(deprecated) +## backgroundTaskManager.cancelSuspendDelay7+ cancelSuspendDelay(requestId: number): void 取消延迟挂起。 -> **说明：** 从API version 9开始废弃，建议使用[backgroundTaskManager.cancelSuspendDelay](./js-apis-resourceschedule-backgroundTaskManager.md/#backgroundtaskmanagercancelsuspenddelay9) -> -> 从 API version 7开始支持。 - **系统能力:** SystemCapability.ResourceSchedule.BackgroundTaskManager.TransientTask **参数**： @@ -156,16 +140,12 @@ cancelSuspendDelay(requestId: number): void ``` -## backgroundTaskManager.startBackgroundRunning8+(deprecated) +## backgroundTaskManager.startBackgroundRunning8+ startBackgroundRunning(context: Context, bgMode: BackgroundMode, wantAgent: WantAgent, callback: AsyncCallback<void>): void 向系统申请长时任务，使用callback形式返回结果。 -> **说明：** 从API version 9开始废弃，建议使用[backgroundTaskManager.startBackgroundRunning](./js-apis-resourceschedule-backgroundTaskManager.md/#backgroundtaskmanagerstartbackgroundrunningcallback9) -> -> 从 API version 7开始支持。 - **需要权限:** ohos.permission.KEEP_BACKGROUND_RUNNING **系统能力:** SystemCapability.ResourceSchedule.BackgroundTaskManager.ContinuousTask @@ -251,16 +231,12 @@ export default class MainAbility extends Ability { }; ``` -## backgroundTaskManager.startBackgroundRunning8+(deprecated) +## backgroundTaskManager.startBackgroundRunning8+ startBackgroundRunning(context: Context, bgMode: BackgroundMode, wantAgent: WantAgent): Promise<void> 向系统申请长时任务，使用promise形式返回结果。 -> **说明：** 从API version 9开始废弃，建议使用[backgroundTaskManager.startBackgroundRunning](./js-apis-resourceschedule-backgroundTaskManager.md/#backgroundtaskmanagerstartbackgroundrunningpromise9) -> -> 从 API version 7开始支持。 - **需要权限:** ohos.permission.KEEP_BACKGROUND_RUNNING **系统能力:** SystemCapability.ResourceSchedule.BackgroundTaskManager.ContinuousTask @@ -342,16 +318,12 @@ export default class MainAbility extends Ability { }; ``` -## backgroundTaskManager.stopBackgroundRunning8+(deprecated) +## backgroundTaskManager.stopBackgroundRunning8+ stopBackgroundRunning(context: Context, callback: AsyncCallback<void>): void 向系统申请取消长时任务，使用callback形式返回结果。 -> **说明：** 从API version 9开始废弃，建议使用[backgroundTaskManager.stopBackgroundRunning](./js-apis-resourceschedule-backgroundTaskManager.md/#backgroundtaskmanagerstopbackgroundrunningcallback9) -> -> 从 API version 7开始支持。 - **系统能力:** SystemCapability.ResourceSchedule.BackgroundTaskManager.ContinuousTask **参数**： @@ -401,16 +373,12 @@ export default class MainAbility extends Ability { }; ``` -## backgroundTaskManager.stopBackgroundRunning8+(deprecated) +## backgroundTaskManager.stopBackgroundRunning8+ stopBackgroundRunning(context: Context): Promise<void> 向系统申请取消长时任务，使用promise形式返回结果。 -> **说明：** 从API version 9开始废弃，建议使用[backgroundTaskManager.stopBackgroundRunning](./js-apis-resourceschedule-backgroundTaskManager.md/#backgroundtaskmanagerstopbackgroundrunningpromise9) -> -> 从 API version 7开始支持。 - **系统能力:** SystemCapability.ResourceSchedule.BackgroundTaskManager.ContinuousTask **参数**： @@ -456,7 +424,7 @@ export default class MainAbility extends Ability { }; ``` -## backgroundTaskManager.applyEfficiencyResources9+(deprecated) +## backgroundTaskManager.applyEfficiencyResources9+ applyEfficiencyResources(request: [EfficiencyResourcesRequest](#efficiencyresourcesrequest9)): void @@ -465,10 +433,6 @@ applyEfficiencyResources(request: [EfficiencyResourcesRequest](#efficiencyresour 应用使用此接口，需要向应用中心申请获得相应特权。 进程和它所属的应用可以同时申请某一类资源，例如CPU资源，但是应用释放资源的时候会将进程的资源一起释放。 -> **说明：** 从API version 9开始废弃，建议使用[backgroundTaskManager.applyEfficiencyResources](./js-apis-resourceschedule-backgroundTaskManager.md/#backgroundtaskmanagerapplyefficiencyresources9) -> -> 从 API version 9开始支持。 - **系统能力**: SystemCapability.ResourceSchedule.BackgroundTaskManager.EfficiencyResourcesApply **系统API**: 此接口为系统接口。 @@ -501,17 +465,13 @@ try { } ``` -## backgroundTaskManager.resetAllEfficiencyResources9+(deprecated) +## backgroundTaskManager.resetAllEfficiencyResources9+ resetAllEfficiencyResources(): void 释放所有已经申请的资源。 应用使用此接口，需要向应用中心申请获得相应特权。 -> **说明：** 从API version 9开始废弃，建议使用[backgroundTaskManager.resetAllEfficiencyResources](./js-apis-resourceschedule-backgroundTaskManager.md/#backgroundtaskmanagerresetallefficiencyresources9) -> -> 从 API version 9开始支持。 - **系统能力:** SystemCapability.ResourceSchedule.BackgroundTaskManager.EfficiencyResourcesApply **系统API**: 此接口为系统接口。 @@ -528,14 +488,10 @@ try { } ``` -## DelaySuspendInfo7+(deprecated) +## DelaySuspendInfo7+ 延迟挂起信息。 -> **说明：** 从API version 9开始废弃，建议使用[backgroundTaskManager.DelaySuspendInfo](./js-apis-resourceschedule-backgroundTaskManager.md/#backgroundtaskmanagerdelaysuspendinfo9) -> -> 从 API version 7开始支持。 - **系统能力:** SystemCapability.ResourceSchedule.BackgroundTaskManager.TransientTask | 参数名 | 类型 | 必填 | 说明 | @@ -544,7 +500,7 @@ try { | actualDelayTime | number | 是 | 应用的实际挂起延迟时间，以毫秒为单位。
一般情况下默认值为180000，低电量（依据系统低电量广播）时默认值为60000。 | -## BackgroundMode8+(deprecated) +## BackgroundMode8+ **系统能力:** SystemCapability.ResourceSchedule.BackgroundTaskManager.ContinuousTask @@ -560,14 +516,10 @@ try { | VOIP | 8 | 音视频通话
此接口为系统接口。 | | TASK_KEEPING | 9 | 计算任务（仅在特定设备生效）。 | -## EfficiencyResourcesRequest9+(deprecated) +## EfficiencyResourcesRequest9+ 能效资源申请参数。 -> **说明：** 从API version 9开始废弃，建议使用[backgroundTaskManager.EfficiencyResourcesRequest](./js-apis-resourceschedule-backgroundTaskManager.md/#backgroundtaskmanagerefficiencyresourcesrequest9) -> -> 从 API version 9开始支持。 - **系统能力:** SystemCapability.ResourceSchedule.BackgroundTaskManager.EfficiencyResourcesApply **系统API**: 此接口为系统接口。 @@ -581,14 +533,10 @@ try { | isProcess | boolean | 否 | 应用申请或者是进程申请。 | | reason | string | 是 | 申请资源的原因。 | -## ResourceType9+(deprecated) +## ResourceType9+ 能效资源类型。 -> **说明：** 从API version 9开始废弃，建议使用[backgroundTaskManager.ResourceType](./js-apis-resourceschedule-backgroundTaskManager.md/#backgroundtaskmanagerresourcetype9) -> -> 从 API version 9开始支持。 - **系统能力:** SystemCapability.ResourceSchedule.BackgroundTaskManager.EfficiencyResourcesApply **系统API**: 此接口为系统接口。 -- GitLab