harmony 鸿蒙BackgroundProcessManager

2025-06-12
浏览 (3)

BackgroundProcessManager

概述

提供后台子进程调度策略管控C接口。

起始版本： 17

汇总

文件

名称	描述
background_process_manager.h	本模块提供了后台子进程管控接口。开发者可以通过本模块接口对子进程进行压制、解压制，避免子进程过多占用系统资源，导致系统使用卡顿。本模块接口仅对通过OH_Ability_StartNativeChildProcess接口创建的子进程生效。

类型定义

名称	描述
typedef enum BackgroundProcessManager_ProcessPriority BackgroundProcessManager_ProcessPriority	子进程压制档位。
typedef enum BackgroundProcessManager_ErrorCode BackgroundProcessManager_ErrorCode	定义后台子进程管控错误码。

枚举

名称	描述
BackgroundProcessManager_ProcessPriority { PROCESS_BACKGROUND = 1, PROCESS_INACTIVE = 2 }	子进程压制档位。
BackgroundProcessManager_ErrorCode { ERR_BACKGROUND_PROCESS_MANAGER_SUCCESS = 0, ERR_BACKGROUND_PROCESS_MANAGER_INVALID_PARAM = 401, ERR_BACKGROUND_PROCESS_MANAGER_REMOTE_ERROR = 31800001 }	定义后台子进程管控错误码。

函数

名称	描述
int OH_BackgroundProcessManager_SetProcessPriority (int pid, BackgroundProcessManager_ProcessPriority priority)	设置子进程的压制档位，子进程被压制后可获得的CPU资源将会受到限制。如果主进程调度策略发生变化，如从后台切至前台等，子进程会跟随主进程一同变化，子进程如需继续压制，需要重新调用本接口。
int OH_BackgroundProcessManager_ResetProcessPriority (int pid)	为子进程解压制，即子进程策略恢复为主进程调度策略。若主进程调度策略发生变化，如从后台切至前台等，子进程会跟随主进程一同变化，等效于执行一次resetProcessPriority动作。

类型定义说明

BackgroundProcessManager_ErrorCode

typedef enum BackgroundProcessManager_ErrorCodeBackgroundProcessManager_ErrorCode

描述

定义后台子进程管控错误码。

起始版本： 17

BackgroundProcessManager_ProcessPriority

typedef enum BackgroundProcessManager_ProcessPriorityBackgroundProcessManager_ProcessPriority

描述

子进程压制档位。

起始版本： 17

枚举类型说明

BackgroundProcessManager_ErrorCode

enum BackgroundProcessManager_ErrorCode

描述

定义后台子进程管控错误码。

起始版本： 17

枚举值	描述
ERR_BACKGROUND_PROCESS_MANAGER_SUCCESS	压制参数发送成功。
ERR_BACKGROUND_PROCESS_MANAGER_INVALID_PARAM	参数检查失败。
ERR_BACKGROUND_PROCESS_MANAGER_REMOTE_ERROR	客户端进程请求系统服务进程，获取系统服务操作失败。

BackgroundProcessManager_ProcessPriority

enum BackgroundProcessManager_ProcessPriority

描述

子进程压制档位。

起始版本： 17

枚举值	描述
PROCESS_BACKGROUND	该档位相较PROCESS_INACTIVE压制效果更显著，获取到的CPU资源更少。推荐执行处于后台的图文页面等用户无感知业务的后台子进程时设置该档位。
PROCESS_INACTIVE	推荐正在执行播放音频、导航等用户可感知业务的后台子进程时设置该档位。

函数说明

OH_BackgroundProcessManager_ResetProcessPriority()

int OH_BackgroundProcessManager_ResetProcessPriority (int pid)

描述

为子进程解压制，即子进程策略恢复为主进程调度策略。若主进程调度策略发生变化，如从后台切至前台等，子进程会跟随主进程一同变化，等效于执行一次resetProcessPriority动作。

起始版本： 17

参数:

名称	描述
pid	子进程的进程号，OH_Ability_StartNativeChildProcess接口创建子进程后的pid参数，即为子进程进程号。

返回：

返回执行的错误码。错误码定义详见BackgroundProcessManager_ErrorCode。返回 ERR_BACKGROUND_PROCESS_MANAGER_SUCCESS，表示压制参数发送成功。返回 ERR_BACKGROUND_PROCESS_MANAGER_REMOTE_ERROR，表示客户端进程请求系统服务进程，获取系统服务操作失败。

OH_BackgroundProcessManager_SetProcessPriority()

int OH_BackgroundProcessManager_SetProcessPriority (int pid, BackgroundProcessManager_ProcessPriority priority )

描述

设置子进程的压制档位，子进程被压制后可获得的CPU资源将会受到限制。如果主进程调度策略发生变化，如从后台切至前台等，子进程会跟随主进程一同变化，子进程如需继续压制，需要重新调用本接口。

起始版本： 17

参数:

名称	描述
pid	需要被压制子进程的进程号，OH_Ability_StartNativeChildProcess接口创建子进程后的pid参数，即为子进程进程号。
priority	压制档位。

返回：

返回执行的错误码。错误码定义详见BackgroundProcessManager_ErrorCode。返回 ERR_BACKGROUND_PROCESS_MANAGER_SUCCESS，表示压制参数发送成功。返回 ERR_BACKGROUND_PROCESS_MANAGER_INVALID_PARAM，表示参数检查失败。返回 ERR_BACKGROUND_PROCESS_MANAGER_REMOTE_ERROR，表示客户端进程请求系统服务进程，获取系统服务操作失败。