Passer au contenu principal
Retour aux plugins

Gestionnaire de statistiques d'utilisation

Accédez aux statistiques d'utilisation Android pour suivre le temps d'utilisation de l'application et les analyses de temps d'écran

Guide

Tutoriel sur l'Utilisation des Statistiques de Statut

Utilisation de @capgo/capacitor-android-usagestatsmanager

Capacitor plugin pour l'accès 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 d'utilisation des statistiques est accordée.
  • openUsageStatsSettings - Ouvre 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.
  • queryAllPackages - Effectue des requêtes sur tous les packages installés sur le dispositif. Cela nécessite la permission QUERY_ALL_PACKAGES.

Exemple d'utilisation

queryAndAggregateUsageStats

Statistiques d'utilisation et agrégation 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érifiez 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 d'utilisation des statistiques. Cela ouvrira l'écran de paramètres d'utilisation des statistiques, 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

Recherchez toutes les packages installés sur le dispositif. Cela nécessite 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

Continuez à partir de l'utilisation de @capgo/capacitor-android-usagestatsmanager

Si vous utilisez L'utilisation de @capgo/capacitor-android-usagestatsmanager pour planifier le tableau de bord et les opérations API, connectez-le @capgo/capacitor-gestiondesstatistiquesdutilisation-android pour les détails d'implémentation dans @capgo/capacitor-gestiondesstatistiquesdutilisation-android, Démarrage pour les détails d'implémentation dans Démarrage, API Vue d'ensemble pour les détails d'implémentation dans API Vue d'ensemble, Introduction pour les détails d'implémentation dans Introduction, et API Clés pour les détails d'implémentation dans API Clés.