BundleActiveInfosMgr

java.lang.Object
- ohos.bundleactive.BundleActiveInfosMgr

```
public final class BundleActiveInfosMgr
extends Object
```
Provides methods for managing bundle usage statistics, including the methods for querying bundle usage information and state data.
You can use the methods defined in this class to query the usage history and states of bundles in a specified period. The system stores the query result in a BundleActiveInfos or BundleActiveStates instance and then returns it to you.

从以下版本开始:

4

SystemCapability

SystemCapability.ResourceSchedule#BUNDLE_ACTIVE

字段概要

字段
限定符和类型	字段	说明
`static int`	`BY_ANNUALLY`	Indicates the annually interval.
`static int`	`BY_DAILY`	Indicates the daily interval.
`static int`	`BY_MONTHLY`	Indicates the monthly interval.
`static int`	`BY_OPTIMIZED`	Indicates the interval type that will determine the optimal interval based on the start and end time.
`static int`	`BY_WEEKLY`	Indicates the weekly interval.
`static int`	`USAGE_PRIORITY_GROUP_ALIVE`	Indicates that the application was used recently, is being used, or will be used soon.
`static int`	`USAGE_PRIORITY_GROUP_NEVER`	Indicates that the application has never been used.
`static int`	`USAGE_PRIORITY_GROUP_OFTEN`	Indicates that the application was used in the last few days and may be used in the next few days, but it is not in the active state right now.
`static int`	`USAGE_PRIORITY_GROUP_PREFERENCE`	Indicates that the application was used recently and may be used in the next few hours, but it is not in the active state right now.
`static int`	`USAGE_PRIORITY_GROUP_PRIVILEGE`	Indicates that the application is in the privileged priority group.
`static int`	`USAGE_PRIORITY_GROUP_SELDOM`	Indicates that the application has not been used in the past few days and is unlikely to be used in the next few days.

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法	说明
`boolean`	`isIdleState(String bundleName)`	Checks whether the application with a specified bundle name is in the idle state.
`static BundleActiveInfosMgr`	`newInstance(Context context)`	A static factory method used to create a `BundleActiveInfosMgr` instance based on a specified context.
`int`	`queryAppUsagePriorityGroup()`	Queries the usage priority group of the calling application.
`Map<String,BundleActiveInfos>`	`queryBundleActiveInfos(long begin, long end)`	Queries usage information about each bundle within a specified period.
`List<BundleActiveInfos>`	`queryBundleActiveInfosByInterval(int byInterval, long begin, long end)`	Queries usage information about each bundle within a specified period at a specified interval.
`BundleActiveStates`	`queryBundleActiveStates(long begin, long end)`	Queries state data of all bundles within a specified period identified by the start and end time.
`BundleActiveStates`	`queryCurrentBundleActiveStates(long begin, long end)`	Queries state data of the current bundle within a specified period.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - BY_ANNUALLY
```
public static final int BY_ANNUALLY
```
    Indicates the annually interval.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    queryBundleActiveInfosByInterval(int, long, long)
  - BY_DAILY
```
public static final int BY_DAILY
```
    Indicates the daily interval.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    queryBundleActiveInfosByInterval(int, long, long)
  - BY_MONTHLY
```
public static final int BY_MONTHLY
```
    Indicates the monthly interval.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    queryBundleActiveInfosByInterval(int, long, long)
  - BY_OPTIMIZED
```
public static final int BY_OPTIMIZED
```
    Indicates the interval type that will determine the optimal interval based on the start and end time.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    queryBundleActiveInfosByInterval(int, long, long)
  - BY_WEEKLY
```
public static final int BY_WEEKLY
```
    Indicates the weekly interval.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    queryBundleActiveInfosByInterval(int, long, long)
  - USAGE_PRIORITY_GROUP_ALIVE
```
public static final int USAGE_PRIORITY_GROUP_ALIVE
```
    Indicates that the application was used recently, is being used, or will be used soon.
    For an application in this priority group, the system does not restrict its resource usage, including background tasks and alarms.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    queryAppUsagePriorityGroup()
  - USAGE_PRIORITY_GROUP_NEVER
```
public static final int USAGE_PRIORITY_GROUP_NEVER
```
    Indicates that the application has never been used.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    queryAppUsagePriorityGroup()
  - USAGE_PRIORITY_GROUP_OFTEN
```
public static final int USAGE_PRIORITY_GROUP_OFTEN
```
    Indicates that the application was used in the last few days and may be used in the next few days, but it is not in the active state right now.
    For an application in this priority group, the system restricts some of its resource usage. For example, the system may postpone its background tasks and alarms more extensively.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    queryAppUsagePriorityGroup()
  - USAGE_PRIORITY_GROUP_PREFERENCE
```
public static final int USAGE_PRIORITY_GROUP_PREFERENCE
```
    Indicates that the application was used recently and may be used in the next few hours, but it is not in the active state right now.
    For an application in this priority group, the system restricts a small amount of its resource usage. For example, the system may postpone its background tasks and alarms.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    queryAppUsagePriorityGroup()
  - USAGE_PRIORITY_GROUP_PRIVILEGE
```
public static final int USAGE_PRIORITY_GROUP_PRIVILEGE
```
    Indicates that the application is in the privileged priority group.
    When the application is in the allowlist or for some reason, its privileged priority will not be changed.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    queryAppUsagePriorityGroup()
  - USAGE_PRIORITY_GROUP_SELDOM
```
public static final int USAGE_PRIORITY_GROUP_SELDOM
```
    Indicates that the application has not been used in the past few days and is unlikely to be used in the next few days.
    For an application in this priority group, the system restricts most of its resource usage, including the network usage.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    queryAppUsagePriorityGroup()
- 方法详细资料
  - newInstance
```
public static BundleActiveInfosMgr newInstance(Context context)
```
    A static factory method used to create a BundleActiveInfosMgr instance based on a specified context.
    
    参数:
    
    context - Indicates the application context.
    
    返回:
    
    Returns the BundleActiveInfosMgr instance created if the operation is successful; returns null if the context is null.
    
    从以下版本开始:
    
    4
  - queryBundleActiveInfosByInterval
```
public List<BundleActiveInfos> queryBundleActiveInfosByInterval(int byInterval,
                                                                long begin,
                                                                long end)
```
    Queries usage information about each bundle within a specified period at a specified interval.
    Permissions: SystemPermission.BUNDLE_ACTIVE_INFO
    
    参数:
    
    byInterval - Indicates the interval at which the usage statistics are queried. The value can be BY_OPTIMIZED, BY_DAILY, BY_WEEKLY, BY_MONTHLY, or BY_ANNUALLY.
    
    begin - Indicates the start time of the query period, in System.currentTimeMillis() format.
    
    end - Indicates the end time of the query period, in System.currentTimeMillis() format.
    
    返回:
    
    Returns the list of BundleActiveInfos objects containing the usage information about each bundle.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    queryBundleActiveInfos(long, long)
  - queryBundleActiveInfos
```
public Map<String,BundleActiveInfos> queryBundleActiveInfos(long begin,
                                                            long end)
```
    Queries usage information about each bundle within a specified period.
    This method queries usage information at the BY_OPTIMIZED interval by default.
    
    Permissions: SystemPermission.BUNDLE_ACTIVE_INFO
    
    参数:
    
    begin - Indicates the start time of the query period, in System.currentTimeMillis() format.
    
    end - Indicates the end time of the query period, in System.currentTimeMillis() format.
    
    返回:
    
    Returns the map of BundleActiveInfos objects containing the usage information about each bundle. The key value in the Map object indicates the bundle name.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    queryBundleActiveInfosByInterval(int, long, long)
  - queryBundleActiveStates
```
public BundleActiveStates queryBundleActiveStates(long begin,
                                                  long end)
```
    Queries state data of all bundles within a specified period identified by the start and end time.
    Permissions: SystemPermission.BUNDLE_ACTIVE_INFO
    
    参数:
    
    begin - Indicates the start time of the query period, in System.currentTimeMillis() format.
    
    end - Indicates the end time of the query period, in System.currentTimeMillis() format.
    
    返回:
    
    Returns the BundleActiveStates object containing the state data of all bundles.
    
    从以下版本开始:
    
    4
  - queryCurrentBundleActiveStates
```
public BundleActiveStates queryCurrentBundleActiveStates(long begin,
                                                         long end)
```
    Queries state data of the current bundle within a specified period.
    
    参数:
    
    begin - Indicates the start time of the query period, in System.currentTimeMillis() format.
    
    end - Indicates the end time of the query period, in System.currentTimeMillis() format.
    
    返回:
    
    Returns the BundleActiveStates object containing the state data of the current bundle.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    queryBundleActiveStates(long, long)
  - isIdleState
```
public boolean isIdleState(String bundleName)
```
    Checks whether the application with a specified bundle name is in the idle state.
    
    参数:
    
    bundleName - Indicates the bundle name of the application to query.
    
    返回:
    
    Returns true if the application is idle in a particular period; returns false otherwise. The time range of the particular period is defined by the system, which may be hours or days.
    
    从以下版本开始:
    
    4
  - queryAppUsagePriorityGroup
```
public int queryAppUsagePriorityGroup()
```
    Queries the usage priority group of the calling application.
    The priority defined in a priority group restricts the resource usage of an application, for example, restricting the running of background tasks.
    
    返回:
    
    Returns the usage priority group of the calling application.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    USAGE_PRIORITY_GROUP_PRIVILEGE, USAGE_PRIORITY_GROUP_ALIVE, USAGE_PRIORITY_GROUP_PREFERENCE, USAGE_PRIORITY_GROUP_OFTEN, USAGE_PRIORITY_GROUP_SELDOM, USAGE_PRIORITY_GROUP_NEVER

类 BundleActiveInfosMgr

字段概要

方法概要

从类继承的方法 java.lang.Object

字段详细资料

BY_ANNUALLY

BY_DAILY

BY_MONTHLY

BY_OPTIMIZED

BY_WEEKLY

USAGE_PRIORITY_GROUP_ALIVE

USAGE_PRIORITY_GROUP_NEVER

USAGE_PRIORITY_GROUP_OFTEN

USAGE_PRIORITY_GROUP_PREFERENCE

USAGE_PRIORITY_GROUP_PRIVILEGE

USAGE_PRIORITY_GROUP_SELDOM

方法详细资料

newInstance

queryBundleActiveInfosByInterval

queryBundleActiveInfos

queryBundleActiveStates

queryCurrentBundleActiveStates

isIdleState

queryAppUsagePriorityGroup