Saltar al contenido principal
@capgo/capacitor-información del dispositivo APIs de dispositivo Fuente abierta

Device Info plugin de Capacitor

Leer métricas de CPU, memoria, GPU, almacenamiento, estado térmico y sensores integrados de las aplicaciones Capacitor

Instalar

bun add @capgo/capacitor-device-info bunx cap sync
npm, pnpm o yarn
  • npm install @capgo/capacitor-device-info
  • pnpm add @capgo/capacitor-device-info
  • yarn add @capgo/capacitor-device-info

Guía

Cómo usar Device Info en Capacitor

Usando @capgo/capacitor-device-info

Lee métricas de CPU, memoria, GPU, almacenamiento, termal, bajo consumo y sensores integrados de una aplicación Capacitor.

Compatibilidad

Este plugin requiere Capacitor 8 o posterior (@capacitor/core >=8.0.0).

Instalar

npm install @capgo/capacitor-device-info
npx cap sync

¿Qué expone este plugin?

  • getInfo - Leer una instantánea con CPU, memoria, GPU, almacenamiento, estado térmico, modo de bajo consumo y sensores integrados.
  • startMonitoring - Iniciar instantáneas periódicas para tableros de gráficos y paneles de diagnóstico.
  • stopMonitoring - Detener el flujo activo.
  • isMonitoring Verificar el estado del flujo y el número de muestras emitidas.
  • removeAllListeners - Eliminar cada oyente registrado en el plugin.
  • deviceInfoUpdate - Se emite un evento de oyente para cada muestra periódica.

- Ejemplo de uso

import { DeviceInfo } from '@capgo/capacitor-device-info';

const snapshot = await DeviceInfo.getInfo();

console.log(snapshot.cpu.cores);
console.log(snapshot.memory.usedPercent);
console.log(snapshot.gpu?.renderer);
console.log(snapshot.sensors?.pressureHpa);

- Fluir métricas a un gráfico

import { DeviceInfo } from '@capgo/capacitor-device-info';

const samples: number[] = [];

const handle = await DeviceInfo.addListener('deviceInfoUpdate', (sample) => {
  if (typeof sample.cpu.usagePercent === 'number') {
    samples.push(sample.cpu.usagePercent);
  }
});

await DeviceInfo.startMonitoring({
  intervalMs: 1000,
  emitImmediately: true,
});

// Later:
await DeviceInfo.stopMonitoring();
await handle.remove();

Muestre valores cada 1000 ms, limita intervalos inferiores a 250 ms y emite un valor instantáneo a menos que establezca emitImmediately: false- . Llamar startMonitoring() vuelve a reiniciar la sesión activa con las nuevas opciones. Cada evento incluye su sequence, startedAt, y elapsedMs.

Usar durationMs o sampleCount Reinicia automáticamente. Si ya no necesita ningún escuchador, llama await DeviceInfo.removeAllListeners().

Notas del sensor de Onboard

Las lecturas de sensores son opcionales porque los dispositivos exponen diferentes hardware. Android puede informar la temperatura de la batería, la temperatura ambiente, la humedad, la presión barométrica, la luz, la proximidad y los valores de temperatura de CPU/GPU de mejor esfuerzo cuando estén disponibles. iOS informa la disponibilidad de sensores de CoreMotion, el estado térmico y el estado de bajo consumo, pero las API públicas de iOS no exponen temperaturas de CPU o GPU reales.

El plugin no obtiene datos de clima. La temperatura exterior y la humedad requieren una integración de ubicación y clima separada API.

Referencia completa

Sigue adelante

Si estás utilizando @capgo/capacitor-información del dispositivo para construir pantallas de diagnóstico o de monitoreo, conecta con @capgo/capacitor-información del dispositivo para la visión general, Getting Started para instalar y API ejemplos, Usando @capgo/capacitor-barómetro para streaming de presión dedicado, y Usando @capgo/capacitor-sensor de luz para lecturas de luz dedicadas.

FAQ

FAQ del plugin Device Info

Cómo instalo el plugin Device Info en una aplicación Capacitor?

Ejecuta "bun add @capgo/capacitor-device-info" (o "npm install @capgo/capacitor-device-info"), luego ejecuta "bunx cap sync" para que los proyectos iOS y Android capturen el nativo code. Importa desde "@capgo/capacitor-device-info" en tu aplicación code.

¿Funciona @capgo/capacitor-device-info con React, Vue y Angular?

Sí. Device Info es un paquete Capacitor, por lo que funciona con cualquier framework web que se ejecute dentro de Capacitor, incluyendo Ionic, React, Vue, Angular, Svelte y JavaScript puro.

¿Qué versión de Capacitor soporta @capgo/capacitor-device-info?

Los plugins Capgo siguen la versión mayor de Capacitor: utiliza la versión mayor del plugin que coincida con la versión mayor de Capacitor (por ejemplo, plugin v8 con Capacitor 8). La tabla de compatibilidad en el README del GitHub lista las versiones mantenidas.

¿Es @capgo/capacitor-device-info gratuito y de código abierto?

Sí. El código fuente code está disponible en GitHub en https://github.com/Cap-go/capacitor-device-info/ y el paquete es gratuito para instalar desde npm. Se aceptan informes de errores y solicitudes de cambios.

Puedo actualizar code que utiliza Device Info sin una revisión de la Tienda?

Instalar o actualizar el plugin cambia el nativo code, por lo que necesita una nueva compilación de la tienda. Después de eso, los cambios en JavaScript, HTML y CSS que llaman al plugin pueden enviar directamente con Capgo actualizaciones en vivo.

Envíe cambios de Device Info sin esperar a la revisión del app.

Una vez que el plugin esté en tu tienda de construcción, Capgo actualizaciones en vivo envían los cambios de JavaScript, HTML y CSS a los usuarios en minutos.

Comience con Capgo