Pasar al contenido principal
Volver a plugins

Gestor de estadísticas de uso de Android

Acceda a estadísticas de uso de Android para rastrear el tiempo de uso de la aplicación y el análisis de tiempo de pantalla

Guía

Tutorial sobre el uso del Administrador de estadísticas de uso

Usando @capgo/capacitor-android-usagestatsmanager

Capacitor plugin para acceder al administrador de estadísticas de uso de Android API.

Instalar

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

¿Qué Esta Plugin Exposa

  • queryAndAggregateUsageStats - Consulta y agrupa estadísticas de uso para el rango de tiempo dado.
  • isUsageStatsPermissionGranted - Verifica si se ha concedido la autorización de estadísticas de uso.
  • openUsageStatsSettings - Abre la pantalla de ajustes de estadísticas de uso. Esto abrirá la pantalla de ajustes de estadísticas de uso, que permite al usuario conceder la autorización de estadísticas de uso. Esto siempre abrirá la pantalla de ajustes, incluso si la autorización ya se ha concedido.
  • queryAllPackages - Consulta todos los paquetes instalados en el dispositivo. Requiere la autorización de QUERY_ALL_PACKAGES.

Ejemplo de Uso

queryAndAggregateUsageStats

Consulta y agrupa estadísticas de uso para el rango de tiempo dado.

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

Verifica si se ha concedido la autorización de estadísticas de uso.

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

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

openUsageStatsSettings

Abre la pantalla de ajustes de estadísticas de uso. Esto abrirá la pantalla de ajustes de estadísticas de uso, que permite al usuario conceder la autorización de estadísticas de uso. Esto siempre abrirá la pantalla de ajustes, incluso si la autorización ya se ha concedido.

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

await UsageStatsManager.openUsageStatsSettings();

queryAllPackages

Consulta todos los paquetes instalados en el dispositivo. Requiere la autorización de 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}`);
});

Referencia Completa

Sigue adelante desde el uso de @capgo/capacitor-gestor-de-estadísticas-de-uso-android

Si estás utilizando Usando @capgo/capacitor-gestor-de-estadísticas-de-uso-android para planificar la consola y las operaciones de API, conecta con @capgo/capacitor-gestor-de-estadísticas-de-uso-android para los detalles de implementación en @capgo/capacitor-gestor-de-estadísticas-de-uso-android, Inicio para los detalles de implementación en Inicio, Resumen de API para los detalles de implementación en Resumen de API Introducción para los detalles de implementación en Introducción, y API Claves para los detalles de implementación en API Claves.