如何使用 UsageStatsManager？

Question

背景

Google 已弃用“ActivityManager”类的函数“getRecentTasks”。现在它所做的就是获取当前应用已打开的应用列表。

我什至写了一篇关于它的帖子here on StackOverflow，但我发现这是不可能的。

问题

我已经发了一篇关于它的帖子（here，以及另一个由其他人创建的类似的帖子，here）并要求重新考虑它，Google 决定开设一个新课程，这似乎提供类似的功能（更像是统计信息，但也可能有用），但我不知道如何使用它。

这个类被称为“UsageStatsManager”，我猜是函数“queryUsageStats”完成了这项工作。

此外，它似乎有一个新权限（“android.permission.PACKAGE_USAGE_STATS”），这是一个系统权限，但它是这样写的：

声明权限意味着使用 API 和用户的意图 的设备可以通过设置应用程序授予权限。

Here's 另一个关于此新功能的链接。

我发现了什么

我查看了 Android 的代码，注意到“上下文”有 USAGE_STATS_SERVICE ，在 JavaDocs 中是这样说的：

/**
 * Use with {@link #getSystemService} to retrieve a {@link
 * android.app.UsageStatsManager} for interacting with the status bar.
 *
 * @see #getSystemService
 * @see android.app.UsageStatsManager
 * @hide
 */
public static final String USAGE_STATS_SERVICE = "usagestats";

奇怪的是，它不仅说“status bar”，而且 packageName 也不匹配（应该是“android.app.usage.UsageStatsManager”）。

我还添加了正确的权限：

<uses-permission
    android:name="android.permission.PACKAGE_USAGE_STATS"
    tools:ignore="ProtectedPermissions" />

这是我使用的代码：

  final UsageStatsManager usageStatsManager=(UsageStatsManager)context.getSystemService("usagestats");// Context.USAGE_STATS_SERVICE);
  final int currentYear=Calendar.getInstance().get(Calendar.YEAR);
  final List<UsageStats> queryUsageStats=usageStatsManager.queryUsageStats(UsageStatsManager.INTERVAL_YEARLY,currentYear-2,currentYear);

在模拟器本身中，我去了“Settings"->"security"->"apps with usage access”，并启用了我的应用程序。

但是，在运行代码时，我得到的只是一个空列表...

问题

你如何使用UsageStatsManager ？

另外，您如何让用户以最简单的方式授予权限？还是在应用尝试获取所需信息时自动完成？

尝试使用此类但用户尚未确认时会发生什么？

如何让代码返回一个真实的应用列表？

Answer 1

其实有一个example app included in AOSP sample code:developers/samples/android/system/AppUsageStatistics/

它包括在应用程序中使用UsageStats 所需的所有位：

1. Declaring the permission in AndroidManifest.xml

   <uses-permission android:name="android.permission.PACKAGE_USAGE_STATS"/>

2. Show settings to grant permission to access UsageStatsManager

   startActivity(new Intent(Settings.ACTION_USAGE_ACCESS_SETTINGS));

3. Query UsageStatsManager for statistics.

   Calendar cal = Calendar.getInstance();
   cal.add(Calendar.YEAR, -1);
   List<UsageStats> queryUsageStats = mUsageStatsManager
           .queryUsageStats(intervalType, cal.getTimeInMillis(),
                   System.currentTimeMillis());
   

4. Creating a list of apps based on UsageStats

总结并应用于您的示例：

• 您似乎正确地请求并授予访问使用情况统计信息的权限。
• 您正确获取了UsageStats 系统服务。
• 但是，您查询的时间段太短：参数beginTime 和endTime 以自纪元以​​来的毫秒数为单位。 Calendar 实例可以通过 getTimeinMillis() 为您提供此值。你错误地做的是只给出年份数字（2015 和2017，如果你今天要运行该程序）。这些值被解释为自纪元以来的毫秒数，因此间隔只有 2 毫秒长，是 1970 年的某个时间。

您应该复制我在下面发布的示例，而不是您发布的以下代码 sn-p：

错误：

final int currentYear=Calendar.getInstance().get(Calendar.YEAR);
final List<UsageStats> queryUsageStats=usageStatsManager.queryUsageStats(UsageStatsManager.INTERVAL_YEARLY,currentYear-2,currentYear);

正确：

final long currentTime = System.currentTimeMillis(); // Get current time in milliseconds

final Calendar cal = Calendar.getInstance();
cal.add(Calendar.YEAR, -2); // Set year to beginning of desired period.
final long beginTime = cal.getTimeInMillis(); // Get begin time in milliseconds

final List<UsageStats> queryUsageStats=usageStatsManager.queryUsageStats(UsageStatsManager.INTERVAL_YEARLY, beginTime, currentTime);

Answer 2

如果您想查看特定时间段的使用统计信息，您必须首先计算从纪元开始和结束时间段的时间长度（以毫秒为单位）。 （epoch 是自 1970 年 1 月 1 日星期四 00:00:00 UTC 以来经过的秒数。）或者，正如我将在下面的示例代码中展示的那样，一种简单的方法是以毫秒为单位从当前时间向后计算。

例如，如果你想要过去 4 天的使用情况统计，你可以使用以下代码：

UsageStatsManager mUsageStatsManager = (UsageStatsManager) this.getSystemService(Context.USAGE_STATS_SERVICE);    
List<UsageStats> queryUsageStats = mUsageStatsManager.queryUsageStats(UsageStatsManager.INTERVAL_DAILY,
                    (System.currentTimeMillis() - 345600000), System.currentTimeMillis());

数字 345600000 是 4 天的毫秒数。

对于INTERVAL_TYPE this article 解释得很好。

系统在 4 个不同的时间间隔内收集和汇总数据 它们是：INTERVAL_DAILY、INTERVAL_WEEKLY、INTERVAL_MONTHLY 和 INTERVAL_YEARLY。系统记录时间有限，所以你会 能够每天间隔检索长达 7 天的应用使用数据， 每周间隔最长 4 周，每月最长 6 个月，以及 最终每年最多 2 年。

还有第五种选择： INTERVAL_BEST 将选择四个之间的最佳拟合区间 以上基于您选择的时间跨度。

Answer 3

回答您的最后一个问题“如何让代码返回给我一个真实的应用列表？”。 queryUsageStats 以毫秒为单位获取开始时间和结束时间，而不是 int 中的年份值。

Calendar beginCal = Calendar.getInstance();
beginCal.set(Calendar.DATE, 1);
beginCal.set(Calendar.MONTH, 0);
beginCal.set(Calendar.YEAR, 2012);

Calendar endCal = Calendar.getInstance();
endCal.set(Calendar.DATE, 1);
endCal.set(Calendar.MONTH, 0);
endCal.set(Calendar.YEAR, 2014);

final List<UsageStats> queryUsageStats=usageStatsManager.queryUsageStats(UsageStatsManager.INTERVAL_YEARLY, beginCal.getTimeInMillis(), endCal.getTimeInMillis());

这应该返回 2012 年和 2013 年的 UsageStats 列表（请记住，结束时间不包括最终结果时间范围）。

Answer 4

你可以这样做

//noinspection ResourceType
final UsageStatsManager usageStatsManager=(UsageStatsManager)context.getSystemService("usagestats");// Context.USAGE_STATS_SERVICE);
final int currentYear=Calendar.getInstance().get(Calendar.YEAR);
final List<UsageStats> queryUsageStats=usageStatsManager.queryUsageStats(UsageStatsManager.INTERVAL_YEARLY,currentYear-2,currentYear);

Answer 5

当用户打开通知抽屉或锁定屏幕时，使用 UsageStats 会得到错误信息。您必须使用 UsageStatsManager.queryEvents() 并使用 MOVE_TO_FOREGROUND 事件类型查找最新事件。

Answer 6

我在我的 Github 上创建了一个如何使用 UsageStats 的示例。 希望它可以对某人有所帮助

https://github.com/ColeMurray/UsageStatsSample

Answer 7

我认为文档只是日历内容的简写。我认为它实际上不适用于 2014 年。但是我可能是错的。

为了访问实际的 UsageStats 列表，您需要创建一个具有正确月、日和年的 Calendar 对象。 MRK 在另一个答案中是怎么说的。我复制并更正了 MRK 代码中的错误，以便将来看到它的任何人都可以看到。

Calendar beginCal = Calendar.getInstance();
beginCal.set(Calendar.DATE, 1);
beginCal.set(Calendar.MONTH, 0);
beginCal.set(Calendar.YEAR, 2012);

Calendar endCal = Calendar.getInstance();
endCal.set(Calendar.DATE, 1);
endCal.set(Calendar.MONTH, 0);
endCal.set(Calendar.YEAR, 2014);

final List<UsageStats> queryUsageStats=usageStatsManager.queryUsageStats(UsageStatsManager.INTERVAL_YEARLY, beginCal.getTimeInMillis(), endCal.getTimeInMillis());

-信用 MRK；由我纠正（他不小心把 cal 而不是 beginCal 和 endCal）

使用权限设置的代码如下。 :)

Intent intent = new Intent(Settings.ACTION_USAGE_ACCESS_SETTINGS);
startActivity(intent);