Guida
Come usare Device Info in Capacitor
Usando @capgo/capacitor-device-info
Leggi le metriche di CPU, memoria, GPU, storage, termiche, risparmio energetico e sensori integrati da un'app Capacitor.
Compatibilità
Questo plugin richiede Capacitor 8 o versioni successive (@capacitor/core >=8.0.0).
Installa
npm install @capgo/capacitor-device-info
npx cap sync
Cosa espone questo plugin
getInfo- Leggi uno snapshot con CPU, memoria, GPU, storage, stato termico, modalità risparmio energetico e sensori integrati.startMonitoring- Avvia snapshot periodici per grafici e dashboard di diagnostica.stopMonitoring- Ferma lo stream attivo.isMonitoring- Controlla lo stato dello stream e il numero di campioni emessi.removeAllListeners- Rimuovi tutti i listener registrati sul plugin.deviceInfoUpdate- Evento del listener emesso per ogni campione periodico.
Esempio d'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);
Trasmetti le metriche a 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();
Il monitoraggio avviene con un intervallo predefinito di 1000 ms, con un limite minimo di 250 ms e un campionamento immediato, a meno che non si imposti emitImmediately: false. Chiamare startMonitoring() riavvia la sessione attiva con le nuove opzioni. Ogni evento include il suo sequence, startedAt, e elapsedMs.
Usa durationMs oppure sampleCount per interrompere automaticamente. Se non hai più bisogno di un listener, chiama await DeviceInfo.removeAllListeners().
Note di onboarding del sensore
Le letture dei sensori sono opzionali poiché i dispositivi espongono hardware differenti. Android può riportare temperatura della batteria, temperatura ambiente, umidità, pressione barometrica, luce, prossimità e valori best-effort delle zone termiche CPU/GPU quando disponibili. iOS riporta la disponibilità dei sensori CoreMotion, lo stato termico e lo stato di risparmio energetico, ma le API pubbliche di iOS non espongono la temperatura grezza di CPU o GPU.
Il plugin non recupera dati meteo. La temperatura esterna e l'umidità richiedono un'integrazione separata di geolocalizzazione e meteo API.
Riferimento completo
Continua
Se stai usando @capgo/capacitor-device-info per creare schermate di diagnostica o monitoraggio, collegalo a @capgo/capacitor-device-info per la panoramica, Per iniziare per l'installazione e gli esempi API, Utilizzo di @capgo/capacitor-barometer per lo streaming dedicato della pressione, e Utilizzo di @capgo/capacitor-light-sensor per letture dedicate della luce