Saltare al contenuto principale
Indietro ai plugin

Gestore statistiche usaggi

Accedi alle statistiche di utilizzo Android per tracciare il tempo di utilizzo dell'app e le analisi di tempo di schermo

Guida

Tutorial sull'uso del Manager delle statistiche di utilizzo

Utilizzo di @capgo/capacitor-android-usagestatsmanager

Capacitor plugin per l'accesso al Manager delle statistiche di utilizzo Android API

Installa

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

Cosa questo plugin espone

  • queryAndAggregateUsageStats - Esegue query e aggrega le statistiche di utilizzo per il range di tempo specificato.
  • isUsageStatsPermissionGranted - Controlla se è autorizzato l'accesso alle statistiche di utilizzo.
  • openUsageStatsSettings - Apri la schermata di impostazione delle statistiche di utilizzo. Questo aprirà la schermata di impostazione delle statistiche di utilizzo, che consente all'utente di autorizzare l'accesso alle statistiche di utilizzo. Questo aprirà sempre la schermata di impostazione, anche se il permesso è già stato autorizzato.
  • queryAllPackages - Esegue tutte le query sui pacchetti installati sul dispositivo. Richiede la permessione di QUERY_ALL_PACKAGES.

Esempio di utilizzo

queryAndAggregateUsageStats

Esegue tutte le query e aggrega le statistiche di utilizzo per il range di tempo specificato.

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

Controlla se è stata concessa la permessione per le statistiche di utilizzo.

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

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

openUsageStatsSettings

Apri la schermata di impostazioni delle statistiche di utilizzo. Questo aprirà la schermata di impostazioni delle statistiche di utilizzo, che consente all'utente di concedere la permessione per le statistiche di utilizzo. Questo aprirà sempre la schermata di impostazioni, anche se la permessione è già stata concessa.

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

await UsageStatsManager.openUsageStatsSettings();

queryAllPackages

Esegue tutte le query sui pacchetti installati sul dispositivo. Richiede la permessione di 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}`);
});

Riferimento completo