Guide
Tutoriel sur l'utilisation du Gestionnaire de Statistiques d'Utilisation
Utilisation de @capgo/capacitor-android-usagestatsmanager
Capacitor plugin pour accéder au Gestionnaire de Statistiques d'Utilisation Android API
Installer
bun add @capgo/capacitor-android-usagestatsmanager
bunx cap sync
Ce que ce plugin expose
queryAndAggregateUsageStats- Effectue des requêtes et des agrégations de statistiques d'utilisation pour la plage de temps donnée.isUsageStatsPermissionGranted- Vérifie si la permission de statistiques d'utilisation est accordée.openUsageStatsSettings- Ouvre l'écran de paramétrage des statistiques d'utilisation. Cela ouvrira l'écran de paramétrage des statistiques d'utilisation, qui permet au utilisateur d'accorder la permission de statistiques d'utilisation. Cela ouvrira toujours l'écran de paramétrage, même si la permission est déjà accordée.queryAllPackages- Effectue toutes les requêtes des packages installés sur le dispositif. Exige la permission QUERY_ALL_PACKAGES.
Exemple d'utilisation
queryAndAggregateUsageStats
Effectue et agrège les statistiques d'utilisation pour la plage de temps donnée.
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
Vérifie si la permission d'utilisation des statistiques est accordée.
import { CapacitorUsageStatsManager } from '@capgo/capacitor-android-usagestatsmanager';
const { granted } = await UsageStatsManager.isUsageStatsPermissionGranted();
if (!granted) {
await UsageStatsManager.openUsageStatsSettings();
}
openUsageStatsSettings
Ouvrez l'écran de paramètres des statistiques d'utilisation. Cela ouvrira l'écran de paramètres des statistiques d'utilisation, qui permet au utilisateur d'accorder la permission d'utilisation des statistiques. Cela ouvrira toujours l'écran de paramètres, même si la permission est déjà accordée.
import { CapacitorUsageStatsManager } from '@capgo/capacitor-android-usagestatsmanager';
await UsageStatsManager.openUsageStatsSettings();
queryAllPackages
Effectue toutes les requêtes des packages installés sur le dispositif. Exige la permission 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}`);
});
Référence complète
- GitHub: https://github.com/Cap-go/capacitor-android-usagestatsmanager/
- Docs: /docs/plugins/android-usagestatsmanager/