UsageStatsManager.QueryUsageStats(UsageStatsInterval, Int64, Int64) Method

Definition

Gets application usage stats for the given time range, aggregated by the specified interval.

[Android.Runtime.Register("queryUsageStats", "(IJJ)Ljava/util/List;", "")]
public System.Collections.Generic.IList<Android.App.Usage.UsageStats>? QueryUsageStats (Android.App.Usage.UsageStatsInterval intervalType, long beginTime, long endTime);
[<Android.Runtime.Register("queryUsageStats", "(IJJ)Ljava/util/List;", "")>]
member this.QueryUsageStats : Android.App.Usage.UsageStatsInterval * int64 * int64 -> System.Collections.Generic.IList<Android.App.Usage.UsageStats>

Parameters

intervalType
UsageStatsInterval

The time interval by which the stats are aggregated.

beginTime
Int64

The inclusive beginning of the range of stats to include in the results. Defined in terms of "Unix time", see java.lang.System#currentTimeMillis.

endTime
Int64

The exclusive end of the range of stats to include in the results. Defined in terms of "Unix time", see java.lang.System#currentTimeMillis.

Returns

A list of UsageStats

Attributes

Remarks

Gets application usage stats for the given time range, aggregated by the specified interval.

The returned list will contain one or more UsageStats objects for each package, with usage data that covers at least the given time range. Note: The begin and end times of the time range may be expanded to the nearest whole interval period.

The caller must have android.Manifest.permission#PACKAGE_USAGE_STATS

<em>Note: Starting from android.os.Build.VERSION_CODES#R Android R, if the user's device is not in an unlocked state (as defined by UserManager#isUserUnlocked()), then null will be returned.</em>

Java documentation for android.app.usage.UsageStatsManager.queryUsageStats(int, long, long).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to