Guía
Cómo usar Usage Stats Manager en Capacitor
Usando @capgo/capacitor-android-usagestatsmanager
Plugin Capacitor para acceder a API de Android UsageStatsManager
Instalar
bun add @capgo/capacitor-android-usagestatsmanager
bunx cap sync
Lo que expone este plugin
queryAndAggregateUsageStats- Consulta y agrega estadísticas de uso en el rango de tiempo indicado.isUsageStatsPermissionGranted- Comprueba si el permiso de estadísticas de uso está concedido.openUsageStatsSettingsAbre la pantalla de ajustes de estadísticas de uso. Esto abrirá la configuración de estadísticas de uso para que el usuario pueda conceder el permiso. Siempre abrirá la pantalla de ajustes, aunque el permiso ya esté concedido.queryAllPackagesConsulta todos los paquetes instalados en el dispositivo. Requiere el permiso QUERY_ALL_PACKAGES.
Ejemplo de uso
queryAndAggregateUsageStats
Consulta y agrega estadísticas de uso en el rango de tiempo indicado.
import { CapacitorUsageStatsManager } from '@capgo/capacitor-android-usagestatsmanager';
const oneDayAgo = Date.now() - 24 * 60 * 60 * 1000;
const now = Date.now();
const stats = await CapacitorUsageStatsManager.queryAndAggregateUsageStats({
beginTime: oneDayAgo,
endTime: now
});
for (const [packageName, usageData] of Object.entries(stats)) {
console.log(`${packageName}: ${usageData.totalTimeInForeground}ms`);
}
isUsageStatsPermissionGranted
Comprueba si el permiso de estadísticas de uso está concedido.
import { CapacitorUsageStatsManager } from '@capgo/capacitor-android-usagestatsmanager';
const { granted } = await CapacitorUsageStatsManager.isUsageStatsPermissionGranted();
if (!granted) {
await CapacitorUsageStatsManager.openUsageStatsSettings();
}
openUsageStatsSettings
Abre la pantalla de ajustes de estadísticas de uso. Esto abrirá la configuración de estadísticas de uso para que el usuario pueda conceder el permiso. Siempre abrirá la pantalla de ajustes, aunque el permiso ya esté concedido.
import { CapacitorUsageStatsManager } from '@capgo/capacitor-android-usagestatsmanager';
await CapacitorUsageStatsManager.openUsageStatsSettings();
queryAllPackages
Consulta todos los paquetes instalados en el dispositivo. Requiere el permiso QUERY_ALL_PACKAGES.
import { CapacitorUsageStatsManager } from '@capgo/capacitor-android-usagestatsmanager';
const { packages } = await CapacitorUsageStatsManager.queryAllPackages();
packages.forEach(pkg => {
console.log(`${pkg.appName} (${pkg.packageName}): v${pkg.versionName}`);
});
Referencia completa
- GitHub: https://github.com/Cap-go/capacitor-android-usagestatsmanager/
- Docs: /docs/plugins/android-usagestatsmanager/
Continuar desde Usando @capgo/capacitor-android-usagestatsmanager
Si estás usando Usando @capgo/capacitor-android-usagestatsmanager para planificar las operaciones del dashboard y de API, conéctalo con @capgo/capacitor-android-usagestatsmanager para los detalles de implementación en @capgo/capacitor-android-usagestatsmanager, Primeros pasos para los detalles de implementación en Primeros pasos, Resumen de API para los detalles de implementación en API Overview, Introducción para los detalles de implementación en Introducción, y Claves de API para los detalles de implementación en API Keys.