@capgo/capacitor-android-usagestatsmanager

Aperçu

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

Statistiques d'utilisation

Accédez aux données Android UsageStatsManager SDK 📱

Surveillance des applications

Suivez le temps et la fréquence d’utilisation de chaque application 🕐

Gestion des autorisations

Gérez les autorisations des statistiques d’utilisation de manière transparente 🛡️

Informations sur le colis

Interrogez les détails et les métadonnées du package installé 📦

##Installation

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

Autorisations requises

Ajoutez ces autorisations à 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 de base API

Statistiques d’utilisation

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

Informations sur le colis

• queryAllPackages() - Obtenez 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 autorisations

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

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

Les utilisateurs doivent accorder manuellement ces autorisations 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 et fréquence d’utilisation de l’application
• Première et dernière utilisation
• Temps total au premier plan
• Nombre de lancements

Informations sur le colis

• Nom et version du package
• Temps de pose
• Étiquettes et icônes d’application
• Applications système et applications utilisateur

Cas d’utilisation

• Applications de bien-être numérique : surveillez le temps d’écran et l’utilisation des applications
• Contrôle parental : suivez l’utilisation des appareils des enfants
• Applications de productivité : analysez les habitudes de travail et le temps de concentration
• Analytics : comprenez le comportement des utilisateurs et l’engagement des applications

Android Compatibilité

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

Considérations de sécurité

• L’autorisation des statistiques d’utilisation est sensible et nécessite le consentement de l’utilisateur
• Tenir compte de la confidentialité des utilisateurs lors de la collecte des données d’utilisation
• Mettre en œuvre des pratiques appropriées de traitement et de stockage des données
• Suivez les politiques Google Play pour la collecte de données d’utilisation

##Documents

Consultez la documentation complète pour obtenir des guides de mise en œuvre détaillés et des modèles d’utilisation avancés.