Guide
How to use Device Info in Capacitor
Utilisation de @capgo/capacitor-device-info
Lisez les métriques de CPU, mémoire, GPU, stockage, thermique, faible consommation et capteurs embarqués à partir d'une application Capacitor.
Compatibilité
Cette extension nécessite Capacitor 8 ou ultérieur (@capacitor/core >=8.0.0).
Installation
npm install @capgo/capacitor-device-info
npx cap sync
Ce que ce plugin expose
getInfoLisez une capture instantanée avec CPU, mémoire, GPU, stockage, état thermique, mode faible consommation et capteurs embarqués.startMonitoringPrenez des captures périodiques pour les tableaux de bord de graphiques et de diagnostics.stopMonitoringArrêtez la diffusion active.isMonitoringVérifiez l'état de la diffusion et le nombre d'échantillons émis.removeAllListenersSupprimez tous les écouteurs enregistrés sur le plugin.deviceInfoUpdateÉvénement émis par chaque sample périodique.
Exemple d'utilisation
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);
Flux de métriques dans un graphique
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();
La surveillance par défaut utilise un intervalle de 1000 ms, claque les intervalles inférieurs à 250 ms et émet un sample immédiat à moins que vous n'ayez configuré emitImmediately: false. Appeler startMonitoring() redémarrage de la session active avec les nouvelles options. Chaque événement inclut son sequence, startedAt, et elapsedMs.
Utilisez durationMs ou sampleCount redémarrez automatiquement. Si vous n'avez plus besoin de tout listener, appelez await DeviceInfo.removeAllListeners().
Notes de capteur d'abord
Les lectures de capteur sont optionnelles car les appareils exposent différents matériel. Android peut signaler la température de la batterie, la température ambiante, l'humidité, la pression barométrique, la lumière, la proximité et les valeurs de zone thermique CPU/GPU de meilleure volonté lorsque disponibles. iOS signale la disponibilité du capteur CoreMotion, l'état thermique et l'état à faible consommation, mais les API iOS publiques ne révèlent pas la température CPU ou GPU brute.
Le plugin ne récupère pas les données météorologiques. La température extérieure et l'humidité nécessitent une intégration de localisation et de météo API séparée.
Référence complète
Continuez
Si vous utilisez @capgo/capacitor-informations-sur-le-dispositif pour créer des écrans de diagnostics ou de surveillance, connectez-l’avec @capgo/capacitor-informations-sur-le-dispositif pour une vue d'ensemble, Getting Started pour l'installation et les exemples de API Utilisation de @capgo/capacitor-baromètre pour un flux de pression dédié, et Utilisation de @capgo/capacitor-capteur de lumière pour des lectures de lumière dédiées.