Usage Stats Manager __CAPGO_KEEP_0__ 插件:安装、设置 & 示例
返回插件
@capgo/capacitor-android-usagestatsmanager
教程
@capgo/capacitor-android-usagestatsmanager

使用统计管理器

访问 Android 使用情况统计以跟踪应用程序使用时间和屏幕时间分析

指南

使用统计使用情况管理器的教程

使用@capgo/capacitor-android-usagestatsmanager

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

安装

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 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}`);
});

全局参考

继续使用@capgo/capacitor-android-usagestatsmanager

如果您正在使用 使用@capgo/capacitor-android-usagestatsmanager 来规划仪表板和API操作,连接它与 @capgo/capacitor-android-usagestatsmanager 了解@capgo/capacitor-android-usagestatsmanager的实现细节在@capgo/capacitor-android-usagestatsmanager, 入门指南 了解入门指南的实现细节在入门指南, API概述 for the implementation detail in API 介绍 简介 for the implementation detail in 简介, 和 API 密钥 for the implementation detail in API 密钥。