사용 통계 관리

사용 @capgo/capacitor-android-usagestatsmanager

Capacitor 플러그인으로 Android 사용 통계 관리자 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_KEEP_0__를 사용하고 계신가요? Using @capgo/capacitor-android-usagestatsmanager API와 연결하세요: @API/__CAPGO_KEEP_1__-android-usagestatsmanager @capgo/capacitor-android-usagestatsmanager for the implementation detail in @capgo/capacitor-android-usagestatsmanager, Getting Started for the implementation detail in Getting Started, API Overview for the implementation detail in API Overview, Introduction for the implementation detail in Introduction, and API Keys for the implementation detail in API Keys.