Saltare al contenuto principale
@capgo/capacitor-info-dispositivo API dei dispositivi Open source

Device Info plugin Capacitor

Leggi metriche di CPU, memoria, GPU, storage, stato termico e sensori integrati dai Capacitor app

Installa

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

Guida

Come utilizzare Device Info in Capacitor

Utilizzo di @capgo/capacitor-device-info

Leggi metriche di CPU, memoria, GPU, storage, termica, basso consumo e sensori integrati da un'app Capacitor

Compatibilità

Questo plugin richiede Capacitor 8 o successivi (@capacitor/core >=8.0.0).

Installa

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

Cosa questo plugin espone

  • getInfo - Leggi un snapshot con CPU, memoria, GPU, storage, stato termico, modalità basso consumo e sensori integrati.
  • startMonitoring - Avvia snapshot periodici per dashboard di grafici e diagnostica.
  • stopMonitoring - Ferma lo stream attivo.
  • isMonitoring Verifica lo stato dello stream e il numero di campioni emessi.
  • removeAllListeners - Rimuovi ogni listener registrato sul plugin.
  • deviceInfoUpdate - Evento listener emesso per ogni sample periodico.

Esempio di utilizzo

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);

Influisce lo stream di metriche in un grafico

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();

Monitoring si attiva con un intervallo di 1000 ms, limita gli intervalli sotto i 250 ms e invia un campione immediato a meno che non imposti emitImmediately: false . Chiamare startMonitoring() riavvia di nuovo la sessione attiva con le nuove opzioni. Ogni evento include il suo sequence, startedAt, e elapsedMs.

Usa durationMs o sampleCount fermare automaticamente. Se non hai più bisogno di alcun ascoltatore, chiama await DeviceInfo.removeAllListeners().

Note per sensori di bordo

Sensor readings are optional because devices expose different hardware. Android can report battery temperature, ambient temperature, humidity, barometric pressure, light, proximity, and best-effort CPU/GPU thermal-zone values when available. iOS reports CoreMotion sensor availability, thermal state, and low-power state, but public iOS APIs do not expose raw CPU or GPU temperature.

The plugin does not fetch weather data. Outside temperature and humidity require a separate location and weather API integration.

Riferimento completo

Continua

Se stai utilizzando @capgo/capacitor-device-info per costruire schermate diagnostici o di monitoraggio, connettilo con @capgo/capacitor-device-info per l'overview Getting Started per installare e esempi di API Utilizzando @capgo/capacitor-barometer per flussi di pressione dedicati, e Utilizzando @capgo/capacitor-light-sensor per letture di luce dedicate.

FAQ

Domande frequenti sul plugin Device Info

Come posso installare il plugin Device Info in un'app Capacitor?

Esegui "bun add @capgo/capacitor-device-info" (o "npm install @capgo/capacitor-device-info"), quindi esegui "bunx cap sync" affinché i progetti iOS e Android recuperino le native code. Importalo da "@capgo/capacitor-device-info" nella tua app code.

Funziona @capgo/capacitor-device-info con React, Vue e Angular?

Sì. Device Info è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che esegue all'interno di Capacitor, compresi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Qual è la versione di Capacitor supportata da @capgo/capacitor-device-info?

I plugin Capgo seguono la versione maggiore di Capacitor: utilizza la versione del plugin maggiore che corrisponde alla tua versione maggiore di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README del GitHub elenca le versioni mantenute.

È gratuito e open source @capgo/capacitor-device-info?

Sì. Il codice sorgente code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-device-info/ e il pacchetto è gratuito per l'installazione da npm. Sono accetti i rapporti di bug e le richieste di pull.

Posso aggiornare code che utilizza Device Info senza una revisione dell'App Store?

L'installazione o l'aggiornamento del plugin modifica le native code, quindi richiede una nuova costruzione dello store. Dopo di che, le modifiche JavaScript, HTML e CSS che chiamano il plugin possono essere distribuite immediatamente con Capgo live updates.

Consegui le modifiche di Device Info senza dover attendere la revisione dell'app

Una volta che il plugin è presente nella tua build di store, le Capgo aggiornamenti live inviano le tue modifiche JavaScript, HTML e CSS agli utenti in pochi minuti

Inizia con Capgo