Zum Hauptinhalt springen
Zurück zu plugins
@capgo/capacitor-android-usagestatsmanager
Tutorial
@capgo/capacitor-android-usagestatsmanager

Usage Stats Manager

Zugriff auf Android-Benutzungsstatistiken, um die App-Nutzungszeit und -Screen-Time-Analytics zu verfolgen

Anleitung

Anleitung zum Verständnis des Statistik-Managers

auf Gerät testen

Downloaden Sie die Capgo-App, dann scannen Sie das QR-code.

Plugin-Vorschau-Link für die Verwendungszahlen-Manager-Funktion code

Verwendung von @capgo/capacitor-android-usagestatsmanager

Capacitor-Plugin für den Zugriff auf den Android-Verwendungszahlen-Manager API.

Installieren

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

Was diese Plugin-Funktionen offenlegen

  • queryAndAggregateUsageStats - Abfragen und aggregieren Sie Verwendungszahlen für die angegebene Zeitperiode.
  • isUsageStatsPermissionGranted - Überprüfen Sie, ob die Verwendungszahlen-Berechtigung erteilt wurde.
  • openUsageStatsSettings - Öffnen Sie die Verwendungszahlen-Einstellungen. Dies öffnet die Verwendungszahlen-Einstellungen, die dem Benutzer ermöglichen, die Verwendungszahlen-Berechtigung zu erteilen. Dies öffnet immer die Einstellungen, selbst wenn die Berechtigung bereits erteilt wurde.
  • queryAllPackages - Abfragen Sie alle installierten Pakete auf dem Gerät. Erfordert die Berechtigung zur Abfrage aller Pakete.

Beispiel für die Verwendung

queryAndAggregateUsageStats

- Abfragen und aggregieren Sie Verwendungszahlen für die angegebene Zeitperiode.

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

Überprüft, ob die Berechtigung für die Nutzungsstatistik erteilt wurde.

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

const { granted } = await UsageStatsManager.isUsageStatsPermissionGranted();
if (!granted) {
  await UsageStatsManager.openUsageStatsSettings();
}

openUsageStatsSettings

Öffnet die Einstellungen für die Nutzungsstatistik. Dies öffnet die Einstellungen für die Nutzungsstatistik, die dem Benutzer ermöglichen, die Berechtigung für die Nutzungsstatistik zu erteilen. Dies öffnet immer die Einstellungen, selbst wenn die Berechtigung bereits erteilt wurde.

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

await UsageStatsManager.openUsageStatsSettings();

queryAllPackages

Abfragt alle auf dem Gerät installierten Pakete. Erfordert die Berechtigung 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}`);
});

Vollständige Referenz

Weitermachen von Using @capgo/capacitor-android-usagestatsmanager

Wenn Sie Using verwenden Mit Using @capgo/capacitor-android-usagestatsmanager planen Sie das Dashboard und API-Operationen, verbinden Sie es mit @capgo/capacitor-android-usagestatsmanager zur Implementierungsdetail in @capgo/capacitor-android-usagestatsmanager, Anleitung zum Starten zur Implementierungsdetail in Anleitung zum Starten, API Übersicht zur Implementierungsdetail in API Übersicht, Einführung zur Implementierungsdetail in Einführung, und API Schlüssel zur Implementierungsdetail in API Schlüssel.