Saltare al contenuto principale
Torna ai plugin

Gestione statistiche di impiego

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

Guida

Tutorial sull'Utilizzo del Gestore delle Statistiche di Utilizzo

Utilizzo di @capgo/capacitor-android-usagestatsmanager

Plugin Capacitor per l'accesso al Gestore 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 l'intervallo di tempo specificato.
  • isUsageStatsPermissionGranted - Controlla se è autorizzato l'accesso alle statistiche di utilizzo.
  • openUsageStatsSettings - Apre 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 la autorizzazione è già stata concessa.
  • queryAllPackages - Esegue query su tutti i pacchetti installati sul dispositivo. Richiede la autorizzazione di QUERY_ALL_PACKAGES.

Esempio di Utilizzo

queryAndAggregateUsageStats

Queries and aggregates usage stats for the given time range.

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

Verifica se è stato concesso il permesso per l'uso dei dati statistici.

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

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

openUsageStatsSettings

Apri la schermata di impostazioni per l'uso dei dati statistici. Questo aprirà la schermata di impostazioni per l'uso dei dati statistici, che consente all'utente di concedere il permesso per l'uso dei dati statistici. Questo aprirà sempre la schermata di impostazioni, anche se il permesso è già stato concesso.

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

await UsageStatsManager.openUsageStatsSettings();

queryAllPackages

Query tutti i pacchetti installati sul dispositivo. Richiede il permesso 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

Continua dall'uso di @capgo/capacitor-android-usagestatsmanager

Se stai utilizzando Utilizza @capgo/capacitor-android-usagestatsmanager per pianificare dashboard e API operazioni, connettilo con @capgo/capacitor-gestione-statistiche-di-uso-android per i dettagli di implementazione in @capgo/capacitor-gestione-statistiche-di-uso-android, Iniziare per i dettagli di implementazione in Iniziare, Panoramica di API per i dettagli di implementazione in Panoramica di API, Introduzione per i dettagli di implementazione in Introduzione, e API Chiavi per i dettagli di implementazione in API Chiavi.