Passer à la navigation principale
Retour aux plugins
@capgo/capacitor-android-usagestatsmanager
Tutoriel
@capgo/capacitor-android-usagestatsmanager

Gestionnaire de statistiques d'utilisation

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

Guide

Tutoriel sur le gestionnaire de statistiques d'utilisation

Tester sur appareil

Téléchargez l'application Capgo, puis scannez le code QR code.

Prévisualisation du lien QR du gestionnaire de statistiques d'utilisation du plugin code

Utilisation de @capgo/capacitor-android-usagestatsmanager

Capacitor plugin pour accéder au gestionnaire de statistiques d'utilisation Android API.

Installation

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

Ce que ce plugin expose

  • queryAndAggregateUsageStats - Effectue des requêtes et des agrégats 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 des requêtes de tous les packages installés sur le dispositif. Exige la permission QUERY_ALL_PACKAGES.

- Utilisation d'exemple

queryAndAggregateUsageStats

- Effectue des requêtes et des agrégats de 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é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 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

Interroge tous les packages installés sur l’appareil. 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

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 de API, connectez-l’avec @capgo/capacitor-android-usagestatsmanager pour les détails d'implémentation dans @capgo/capacitor-android-usagestatsmanager, Prise en main pour les détails d'implémentation dans Prise en main, 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 l'Introduction, et API : Clés pour les détails d'implémentation dans API : Clés.