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
- GitHub: https://github.com/Cap-go/capacitor-android-usagestatsmanager/
- Doc: /docs/plugins/android-usagestatsmanager/