@capgo/capacitor-android-usagestatsmanager

Aperçu

Le plugin Capacitor Android Usage Stats Manager expose le SDK UsageStatsManager d’Android aux applications Capacitor, permettant l’accès à des statistiques d’utilisation détaillées des applications et aux données d’utilisation de l’appareil. Ce plugin permet aux développeurs de suivre les modèles d’utilisation des applications, le temps d’écran et les analyses de comportement des utilisateurs sur les appareils Android.

Statistiques d'utilisation

Accéder aux données du SDK UsageStatsManager Android 📱

Surveillance des applications

Suivre le temps d’utilisation et la fréquence des applications individuelles 🕐

Gestion des permissions

Gérer les permissions de statistiques d’utilisation de manière transparente 🛡️

Informations sur les packages

Interroger les détails et métadonnées des packages installés 📦

Installation

npm install @capgo/capacitor-android-usagestatsmanager
npx cap sync

Permissions requises

Ajoutez ces permissions à votre android/app/src/main/AndroidManifest.xml :

<uses-permission android:name="android.permission.PACKAGE_USAGE_STATS" />
<uses-permission android:name="android.permission.QUERY_ALL_PACKAGES" />

Méthodes API principales

Statistiques d’utilisation

• queryAndAggregateUsageStats(options) - Récupérer des statistiques d’utilisation détaillées pour les applications installées
• isUsageStatsPermissionGranted() - Vérifier si la permission de statistiques d’utilisation est accordée
• openUsageStatsSettings() - Ouvrir les paramètres système pour la permission de statistiques d’utilisation

Informations sur les packages

• queryAllPackages() - Obtenir des informations sur tous les packages installés

Exemple d’utilisation

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

// Check if permission is granted
const permissionResult = await AndroidUsageStatsManager.isUsageStatsPermissionGranted();
if (!permissionResult.granted) {
  // Open settings to grant permission
  await AndroidUsageStatsManager.openUsageStatsSettings();
  return;
}

// Query usage statistics
const statsOptions = {
  intervalType: 0, // INTERVAL_DAILY
  startTime: Date.now() - (7 * 24 * 60 * 60 * 1000), // 7 days ago
  endTime: Date.now()
};

const usageStats = await AndroidUsageStatsManager.queryAndAggregateUsageStats(statsOptions);
console.log('Usage statistics:', usageStats);

// Get all installed packages
const packages = await AndroidUsageStatsManager.queryAllPackages();
console.log('Installed packages:', packages);

Gestion des permissions

Le plugin nécessite des permissions spéciales qui ne peuvent pas être accordées via des demandes de permission d’exécution normales :

1. PACKAGE_USAGE_STATS : Permet d’accéder aux statistiques d’utilisation
2. QUERY_ALL_PACKAGES : Requis pour les informations de package (Android 11+)

Les utilisateurs doivent accorder manuellement ces permissions via les paramètres système. Utilisez openUsageStatsSettings() pour diriger les utilisateurs vers la page de paramètres appropriée.

Types de données

Statistiques d’utilisation

• Temps d’utilisation et fréquence de l’application
• Première et dernière fois utilisée
• Temps total au premier plan
• Nombre de lancements

Informations sur les packages

• Nom et version du package
• Heure d’installation
• Libellés et icônes d’application
• Applications système vs utilisateur

Cas d’utilisation

• Applications de bien-être numérique : Surveiller le temps d’écran et l’utilisation des applications
• Contrôles parentaux : Suivre l’utilisation de l’appareil des enfants
• Applications de productivité : Analyser les habitudes de travail et le temps de concentration
• Analyses : Comprendre le comportement des utilisateurs et l’engagement dans les applications

Compatibilité Android

• Version Android minimale : Niveau API 21 (Android 5.0)
• Fonctionnalités avancées : Niveau API 29+ (Android 10+) pour des statistiques améliorées
• Requêtes de packages : Niveau API 30+ (Android 11+) nécessite QUERY_ALL_PACKAGES

Considérations de sécurité

• La permission de statistiques d’utilisation est sensible et nécessite le consentement de l’utilisateur
• Tenez compte de la vie privée de l’utilisateur lors de la collecte de données d’utilisation
• Implémentez des pratiques appropriées de gestion et de stockage des données
• Suivez les politiques de Google Play pour la collecte de données d’utilisation

Documentation

Consultez la documentation complète pour des guides d’implémentation détaillés et des modèles d’utilisation avancés.