메인 콘텐츠로 바로가기
플러그인으로 돌아가기

사용자 통계 관리기

앱 사용 시간과 화면 사용 시간 분석을 위해 안드로이드 사용자 통계에 접근하세요

안내

사용 통계 관리에 대한 튜토리얼

capgo-android-usagestatsmanager를 사용하여 @capgo/capacitor-android-usagestatsmanager

Capacitor 플러그인으로 Android 사용 통계 매니저 API에 접근

설치

bun add @capgo/capacitor-android-usagestatsmanager
bunx cap sync

이 플러그인이 노출하는 것

  • queryAndAggregateUsageStats - 지정된 시간 범위에 대한 사용 통계를 조회하고 집계합니다.
  • isUsageStatsPermissionGranted - 사용 통계 허용 권한이 부여되었는지 확인합니다.
  • openUsageStatsSettings - 사용 통계 설정 화면을 열어줍니다. 사용자에게 사용 통계 허용 권한을 부여하도록 허용하는 화면을 열어줍니다. 허용 권한이 이미 부여되었다면도 항상 설정 화면을 열어줍니다.
  • queryAllPackages - 장치에 설치된 모든 패키지를 조회합니다. QUERY_ALL_PACKAGES 권한이 필요합니다.

예시 사용

queryAndAggregateUsageStats

__CAPGO_KEEP_0__

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

__CAPGO_KEEP_0__

import { CapacitorUsageStatsManager } from '@capgo/capacitor-android-usagestatsmanager';

const { granted } = await UsageStatsManager.isUsageStatsPermissionGranted();
if (!granted) {
  await UsageStatsManager.openUsageStatsSettings();
}

openUsageStatsSettings

__CAPGO_KEEP_0__

import { CapacitorUsageStatsManager } from '@capgo/capacitor-android-usagestatsmanager';

await UsageStatsManager.openUsageStatsSettings();

queryAllPackages

__CAPGO_KEEP_0__

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_KEEP_0__

Keep going from Using @capgo/capacitor-android-usagestatsmanager

__CAPGO_KEEP_0__.com/Cap-go/__CAPGO_KEEP_1__-android-usagestatsmanager/ Using @capgo/capacitor-android-usagestatsmanager API/__CAPGO_KEEP_1__-android-usagestatsmanager/","API","API operations, API @capgo/capacitor-android-usagestatsmanager 구현 세부 사항에 대한 자세한 내용은 @capgo/capacitor-android-usagestatsmanager에서 확인할 수 있습니다. Getting Started Getting Started에 대한 구현 세부 사항은 여기서 확인할 수 있습니다. API Overview API Overview에 대한 구현 세부 사항은 여기서 확인할 수 있습니다. Introduction Introduction에 대한 구현 세부 사항은 여기서 확인할 수 있습니다. API Keys API Keys에 대한 구현 세부 사항은 여기서 확인할 수 있습니다.