使用统计管理器 Capacitor 插件

使用 @capgo/capacitor-android-usagestatsmanager

用于访问 Android UsageStatsManager API 的 Capacitor 插件。

安装

bun add @capgo/capacitor-android-usagestatsmanager
bunx cap sync

插件暴露的内容

• queryAndAggregateUsageStats - 查询并聚合指定时间范围内的使用统计数据。
• isUsageStatsPermissionGranted - 检查是否已授予使用统计权限。
• openUsageStatsSettings - 打开使用统计设置界面。此操作会打开使用统计设置界面，用户可在其中授予使用统计权限。即使已授予该权限，也始终会打开此设置界面。
• queryAllPackages - 查询设备上所有已安装的应用包。需要 QUERY_ALL_PACKAGES 权限。

用法示例

queryAndAggregateUsageStats

查询并聚合指定时间范围内的使用统计数据。

import { CapacitorUsageStatsManager } from '@capgo/capacitor-android-usagestatsmanager';

const oneDayAgo = Date.now() - 24 * 60 * 60 * 1000;
const now = Date.now();
const stats = await CapacitorUsageStatsManager.queryAndAggregateUsageStats({
  beginTime: oneDayAgo,
  endTime: now
});

for (const [packageName, usageData] of Object.entries(stats)) {
  console.log(`${packageName}: ${usageData.totalTimeInForeground}ms`);
}

isUsageStatsPermissionGranted

检查是否已授予使用统计权限。

import { CapacitorUsageStatsManager } from '@capgo/capacitor-android-usagestatsmanager';

const { granted } = await CapacitorUsageStatsManager.isUsageStatsPermissionGranted();
if (!granted) {
  await CapacitorUsageStatsManager.openUsageStatsSettings();
}

openUsageStatsSettings

打开使用统计设置界面。此操作会打开使用统计设置界面，用户可在其中授予使用统计权限。即使已授予该权限，也始终会打开此设置界面。

import { CapacitorUsageStatsManager } from '@capgo/capacitor-android-usagestatsmanager';

await CapacitorUsageStatsManager.openUsageStatsSettings();

queryAllPackages

查询设备上所有已安装的应用包。需要 QUERY_ALL_PACKAGES 权限。

import { CapacitorUsageStatsManager } from '@capgo/capacitor-android-usagestatsmanager';

const { packages } = await CapacitorUsageStatsManager.queryAllPackages();
packages.forEach(pkg => {
  console.log(`${pkg.appName} (${pkg.packageName}): v${pkg.versionName}`);
});

完整参考

• GitHub: https://github.com/Cap-go/capacitor-android-usagestatsmanager/
• 文档：/docs/plugins/android-usagestatsmanager/

从“使用 @capgo/capacitor-android-usagestatsmanager”继续

如果你正在使用 使用 @capgo/capacitor-android-usagestatsmanager 要规划 dashboard 和 API 操作，请将其连接到 @capgo/capacitor-android-usagestatsmanager 有关 @capgo/capacitor-android-usagestatsmanager 中的实现细节， 快速入门 有关“入门指南”中的实现细节， API 概览 关于 API Overview 中的实现细节， 简介 关于简介中的实现细节，以及 API 密钥 关于 API Keys 中的实现细节。