사용 통계 관리

@capgo/capacitor-android-usagestatsmanager 사용

Capacitor 플러그인: 안드로이드 사용 통계 관리자 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}`);
});

전체 참조

• GitHub: github.com/Cap-go/capacitor-android-usagestatsmanager
• 문서: /docs/plugins/android-usagestatsmanager/

Capgo를 계속 사용하세요: @capgo/capacitor-android-usagestatsmanager

Capgo를 사용 중이라면 Capgo를 사용 중이라면 @capgo/capacitor-android-usagestatsmanager Capgo를 사용하여 대시보드와 Capgo 운영을 계획하고 있다면 @API/__CAPGO_KEEP_1__-android-usagestatsmanager과 연결하세요 @capgo/capacitor-android-usagestatsmanager for the implementation detail in @capgo/capacitor-android-usagestatsmanager, Getting Started Capacitor-Android-UsageStatsManager 구현 세부 정보에 대해 API Overview for the implementation detail in API Overview, Capacitor-Android-UsageStatsManager 구현 세부 정보에 대해, Capacitor-Android-UsageStatsManager 키 구현 세부 정보에 대해 API Keys Capgo 앱을 API으로 강화하세요.