Most visited

Recently visited

Results for

Added in API level 21

Summary: Constants | Methods | Inherited Methods | [Expand All]

UsageStatsManager

public final class UsageStatsManager
extends Object

java.lang.Object
	android.app.usage.UsageStatsManager

提供对设备使用历史和统计数据的访问。使用情况数据汇总为时间间隔：天，周，月和年。

When requesting usage data since a particular time, the request might look something like this:

 PAST                   REQUEST_TIME                    TODAY                   FUTURE
 ————————————————————————————||———————————————————————————|-----------------------|
                        YEAR ||                           |                       |
 ————————————————————————————||———————————————————————————|-----------------------|
  MONTH            |         ||                MONTH      |                       |
 ——————————————————|—————————||———————————————————————————|-----------------------|
   |      WEEK     |     WEEK||    |     WEEK     |     WE|EK     |      WEEK     |
 ————————————————————————————||———————————————————|———————|-----------------------|
                             ||           |DAY|DAY|DAY|DAY|DAY|DAY|DAY|DAY|DAY|DAY|
 ————————————————————————————||———————————————————————————|-----------------------|

A request for data in the middle of a time interval will include that interval.

NOTE: This API requires the permission android.permission.PACKAGE_USAGE_STATS, which is a system-level permission and will not be granted to third-party apps. However, declaring the permission implies intention to use the API and the user of the device can grant permission through the Settings application.

摘要(Summary)

常量(Constants)
`int`	`INTERVAL_BEST` 间隔类型将使用给定时间范围内的最佳拟合间隔。
`int`	`INTERVAL_DAILY` 跨越一天的间隔类型。
`int`	`INTERVAL_MONTHLY` 跨越一个月的间隔类型。
`int`	`INTERVAL_WEEKLY` 跨越一周的间隔类型。
`int`	`INTERVAL_YEARLY` 跨越一年的间隔类型。

公共方法(Public methods)
`boolean`	`isAppInactive(String packageName)` 返回指定的应用程序当前是否被视为不活动。
`Map<String, UsageStats>`	`queryAndAggregateUsageStats(long beginTime, long endTime)` 查询给定范围内的所有统计数据（使用该范围内的最佳时间间隔）的便捷方法，合并结果数据，并按包名键入。
`List<ConfigurationStats>`	`queryConfigurations(int intervalType, long beginTime, long endTime)` 获取设备在给定时间范围内的硬件配置，按照指定的时间间隔进行聚合。
`UsageEvents`	`queryEvents(long beginTime, long endTime)` 查询给定时间范围内的事件。
`List<UsageStats>`	`queryUsageStats(int intervalType, long beginTime, long endTime)` 获取给定时间范围内的应用程序使用统计信息，并按指定的时间间隔进行聚合。

继承方法(Inherited methods)

From class java.lang.Object

常量(Constants)

INTERVAL_BEST

Added in API level 21

int INTERVAL_BEST

间隔类型将使用给定时间范围内的最佳拟合间隔。见queryUsageStats(int, long, long) 。

常量值：4（0x00000004）

INTERVAL_DAILY

Added in API level 21

int INTERVAL_DAILY

跨越一天的间隔类型。见queryUsageStats(int, long, long) 。

常量值：0（0x00000000）

INTERVAL_MONTHLY

Added in API level 21

int INTERVAL_MONTHLY

跨越一个月的间隔类型。见queryUsageStats(int, long, long) 。

常量值：2（0x00000002）

INTERVAL_WEEKLY

Added in API level 21

int INTERVAL_WEEKLY

跨越一周的间隔类型。见queryUsageStats(int, long, long) 。

常数值：1（0x00000001）

INTERVAL_YEARLY

Added in API level 21

int INTERVAL_YEARLY

跨越一年的间隔类型。见queryUsageStats(int, long, long) 。

常量值：3（0x00000003）

公共方法(Public methods)

isAppInactive

Added in API level 23

boolean isAppInactive (String packageName)

返回指定的应用程序当前是否被视为不活动。如果应用程序未在系统定义的一段时间内直接或间接使用，情况将会如此。这可能是几个小时或几天的量级。

参数(Parameters)
`packageName`	`String`: The package name of the app to query

返回(Returns)
`boolean`	whether the app is currently considered inactive

queryAndAggregateUsageStats

Added in API level 21

Map<String, UsageStats> queryAndAggregateUsageStats (long beginTime, 
                long endTime)

查询给定范围内的所有统计数据（使用该范围内的最佳时间间隔）的便捷方法，合并结果数据，并按包名键入。见queryUsageStats(int, long, long) 。

参数(Parameters)
`beginTime`	`long`: The inclusive beginning of the range of stats to include in the results.
`endTime`	`long`: The exclusive end of the range of stats to include in the results.

返回(Returns)
`Map<String, UsageStats>`	A `Map` keyed by package name, or null if no stats are available.

queryConfigurations

Added in API level 21

List<ConfigurationStats> queryConfigurations (int intervalType, 
                long beginTime, 
                long endTime)

获取设备在给定时间范围内的硬件配置，按照指定的时间间隔进行聚合。结果按照queryUsageStats(int, long, long)顺序queryUsageStats(int, long, long) 。

参数(Parameters)
`intervalType`	`int`: The time interval by which the stats are aggregated.
`beginTime`	`long`: The inclusive beginning of the range of stats to include in the results.
`endTime`	`long`: The exclusive end of the range of stats to include in the results.

返回(Returns)
`List<ConfigurationStats>`	A list of `ConfigurationStats` or null if none are available.

queryEvents

Added in API level 21

UsageEvents queryEvents (long beginTime, 
                long endTime)

查询给定时间范围内的事件。事件只能由系统保留几天。

NOTE: The last few minutes of the event log will be truncated to prevent abuse by applications.

参数(Parameters)
`beginTime`	`long`: The inclusive beginning of the range of events to include in the results.
`endTime`	`long`: The exclusive end of the range of events to include in the results.

返回(Returns)
`UsageEvents`	A `UsageEvents`.

queryUsageStats

Added in API level 21

List<UsageStats> queryUsageStats (int intervalType, 
                long beginTime, 
                long endTime)

获取给定时间范围内的应用程序使用统计信息，并按指定的时间间隔进行聚合。

返回的列表将包含每个数据包的UsageStats对象，该数据包的时间间隔是给定时间范围的子集。为了显示：

 intervalType = INTERVAL_YEARLY
 beginTime = 2013
 endTime = 2015 (exclusive)

 Results:
 2013 - com.example.alpha
 2013 - com.example.beta
 2014 - com.example.alpha
 2014 - com.example.beta
 2014 - com.example.charlie

参数(Parameters)
`intervalType`	`int`: The time interval by which the stats are aggregated.
`beginTime`	`long`: The inclusive beginning of the range of stats to include in the results.
`endTime`	`long`: The exclusive end of the range of stats to include in the results.

返回(Returns)
`List<UsageStats>`	A list of `UsageStats` or null if none are available.

也可以看看：