가이드
Capacitor에서 Usage Stats Manager 사용법
@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 사용하기 대시보드와 API 운영을 계획하려면, 이를 다음 항목과 연결하세요: @capgo/capacitor-android-usagestatsmanager @capgo/capacitor-android-usagestatsmanager의 구현 세부 사항은 시작하기 시작하기 문서의 구현 상세 내용은, API 개요 API Overview의 구현 상세 내용은 소개 Introduction의 구현 세부 사항과, API 키 API Keys의 구현 세부 사항을 참고하세요.