메인 콘텐츠로 건너뛰기
플러그인으로 돌아가기
@capgo/capacitor-android-usagestatsmanager
튜토리얼
@capgo/capacitor-android-usagestatsmanager

사용 통계 관리

Android 사용 통계를 통해 앱 사용 시간과 화면 사용 분석을 추적할 수 있습니다.

Capacitor Android Usage Stats Manager 사용 방법

기기에서 테스트

__CAPGO_KEEP_0__ 앱을 다운로드하고 QR코드 __CAPGO_KEEP_1__를 스캔하세요.

Download the Capgo app, then scan the QR code.

사용 통계 관리자 플러그인 미리보기 QR code

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

전체 참조

capgo에서 계속 진행하세요: @capgo/capacitor-android-usagestatsmanager

__CAPGO_KEEP_0__를 사용하고 계시다면 Using @capgo/capacitor-android-usagestatsmanager API와 연결하세요: @API/__CAPGO_KEEP_1__-android-usagestatsmanager @capgo/capacitor-android-usagestatsmanager Capacitor-Android-UsageStatsManager 구현 세부 정보를 위해 @capgo/capacitor-android-usagestatsmanager에서 시작하기 Capacitor-Android-UsageStatsManager 구현 세부 정보를 위해 시작하기에서 API 개요 Capacitor-Android-UsageStatsManager 구현 세부 정보를 위해 API 개요에서 소개 Capacitor-Android-UsageStatsManager 구현 세부 정보를 위해 소개에서, 그리고 API 키 Capacitor-Android-UsageStatsManager 구현 세부 정보를 위해 API 키에서