指南
使用统计管理器的教程
使用 @capgo/capacitor-android-usagestatsmanager
Capacitor 插件,用于访问 Android UsageStatsManager API
安装
bun add @capgo/capacitor-android-usagestatsmanager
bunx cap sync
What This Plugin Exposes
queryAndAggregateUsageStats- 根据给定时间范围查询和聚合使用统计数据。isUsageStatsPermissionGranted- 检查使用统计权限是否已授权。openUsageStatsSettings- 打开使用统计设置屏幕。该屏幕将打开,允许用户授权使用统计权限。即使权限已授权,也会始终打开设置屏幕。queryAllPackages- 查询设备上安装的所有包。需要 QUERY_ALL_PACKAGES 权限。
Example Usage
queryAndAggregateUsageStats
根据给定时间范围查询和聚合使用统计数据。
import { CapacitorUsageStatsManager } from '@capgo/capacitor-android-usagestatsmanager';
const oneDayAgo = Date.now() - 24 * 60 * 60 * 1000;
const now = Date.now();
const stats = await UsageStatsManager.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 UsageStatsManager.isUsageStatsPermissionGranted();
if (!granted) {
await UsageStatsManager.openUsageStatsSettings();
}
openUsageStatsSettings
打开使用统计设置屏幕。该屏幕将打开,允许用户授权使用统计权限。即使权限已授权,也会始终打开设置屏幕。
import { CapacitorUsageStatsManager } from '@capgo/capacitor-android-usagestatsmanager';
await UsageStatsManager.openUsageStatsSettings();
queryAllPackages
查询设备上安装的所有包。需要 QUERY_ALL_PACKAGES 权限。
import { CapacitorUsageStatsManager } from '@capgo/capacitor-android-usagestatsmanager';
const { packages } = await UsageStatsManager.queryAllPackages();
packages.forEach(pkg => {
console.log(`${pkg.appName} (${pkg.packageName}): v${pkg.versionName}`);
});
Full Reference
- GitHub: https://github.com/Cap-go/capacitor-android-usagestatsmanager/
- 文档:/docs/plugins/android-usagestatsmanager/
继续使用@capgo/capacitor-android-usagestatsmanager
如果您正在使用 使用@capgo/capacitor-android-usagestatsmanager 来规划仪表板和API操作,连接它到 @capgo/capacitor-android-usagestatsmanager 了解@capgo/capacitor-android-usagestatsmanager的实现细节 开始使用 了解开始使用的实现细节 API概述 了解API概述的实现细节 简介 了解简介中的实现细节 API 键 了解API 键中的实现细节