Usando @capgo/capacitor-android-usagestatsmanager

Capacitor plugin para acceder a Android UsageStatsManager API.

Instalar

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

¿Qué se expone con este plugin?

queryAndAggregateUsageStats - Realiza consultas 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 ya se ha concedido la autorización.
queryAllPackages - Consulta todos los paquetes instalados en el dispositivo. Requiere la permiso 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 el permiso 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 el permiso de estadísticas de uso. Esto siempre abrirá la pantalla de ajustes, incluso si el permiso 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 permiso 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

GitHub: https://github.com/Cap-go/capacitor-android-usagestatsmanager/
Documentación: /docs/plugins/android-usagestatsmanager/

Gestor de estadísticas de uso

Tutorial sobre el Administrador de Estadísticas de Uso