가이드
사용 통계 관리자 사용 방법
@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}`);
});
전체 참조
- GitHub: https://github.com/Cap-go/capacitor-android-usagestatsmanager/
- 문서: /docs/plugins/android-usagestatsmanager/
Using @capgo/capacitor-android-usagestatsmanager
__CAPGO_KEEP_0__ 사용 중이시면 Using @capgo/capacitor-android-usagestatsmanager API 대시보드를 계획하고 API 운영을 위해 연결하세요. @capgo/capacitor-android-usagestatsmanager capgo 사용 방법에 대한 구체적인 내용은 @capgo/capacitor-android-usagestatsmanager Getting Started __CAPGO_KEEP_0__ 사용 방법에 대한 구체적인 내용은 Getting Started API 개요 implementation 세부 정보를 위한 API 개요 소개 implementation 세부 정보를 위한 Introduction API 키 implementation 세부 정보를 위한 API 키