能效资源申请（仅对系统特权应用开放）

概述

功能介绍

部分系统基础应用对外提供或者维持系统基本功能，需要长时间运行，如系统为了维持和服务器的连接，需要有一个默认长连接推送服务的应用每隔一小段时间给服务器发送心跳包，为了避免该应用进程被挂起，可以申请能效资源来保障业务的执行。

基本概念

• 能效资源申请接口 ：单独为进程申请CPU等资源的接口，保障系统应用在后台执行的诉求。申请CPU资源后，则应用或进程不被挂起。

• 系统特权应用：配置runningResourcesApply特权应用的系统应用。

约束与限制

• 能效资源仅支持系统特权应用使用。

• CPU支持按照进程维度或应用维度申请，其他资源仅支持按照应用维度申请。

接口说明

表1 申请能效资源主要接口

以下是能效资源开发使用的相关接口，更多接口及使用方式请见后台任务管理。

表2 能效资源申请参数

表3 能效资源类型

开发步骤

1. 导入模块。

   import backgroundTaskManager from '@ohos.resourceschedule.backgroundTaskManager';
   

2. 申请能效资源。

   // 应用需要在后台保持活动状态，不被挂起。
   let request: backgroundTaskManager.EfficiencyResourcesRequest = {
     resourceTypes: backgroundTaskManager.ResourceType.CPU, // 资源类型是CPU资源，保证应用进程不被挂起
     isApply: true, // 申请资源
     timeOut: 0, // 超时时间，超过超时时间后资源自动释放
     reason: "apply", // 申请原因
     isPersist: true, // 永久持有资源
     isProcess: false, // 在应用级别申请
   };
   backgroundTaskManager.applyEfficiencyResources(request);
   console.info("Succeeded in invoking applyEfficiencyResources.");
   

3. 释放能效资源。应用在后台完成工作后，及时释放资源，支持释放部分资源或全部资源。

   // 应用在后台完成了工作后，全部释放能效资源
   backgroundTaskManager.resetAllEfficiencyResources();
   //应用在后台完成了工作后，部分释放能效资源
   let request: backgroundTaskManager.EfficiencyResourcesRequest = {
     resourceTypes: backgroundTaskManager.ResourceType.CPU,
     isApply: false, // 释放资源
     timeOut: 0,
     reason: "apply",
     isPersist: true,
     isProcess: false, // 在应用级别释放资源
   };
   backgroundTaskManager.applyEfficiencyResources(request);
   console.info("Succeeded in invoking applyEfficiencyResources.");
   

   说明： 能效资源申请接口支持动态申请，在任务完成后，建议主动取消能效资源申请，以降低设备耗电速度、保障用户使用流畅度。