Anleitung
Device Info in Capacitor nutzen
Verwendung von @capgo/capacitor-device-info
CPU-, Arbeitsspeicher-, GPU-, Speicherplatz-, Thermal-, Low-Power- und Onboard-Sensormetriken aus einer Capacitor-App auslesen.
Kompatibilität
Dieses Plugin erfordert Capacitor 8 oder neuer (@capacitor/core >=8.0.0).
Installieren
npm install @capgo/capacitor-device-info
npx cap sync
Was dieses Plugin bereitstellt
getInfo- Einmalig einen Snapshot mit CPU, Speicher, GPU, Speicherplatz, thermischem Zustand, Energiesparmodus und eingebauten Sensoren lesen.startMonitoring- Periodische Snapshots für Diagramme und Diagnose-Dashboards starten.stopMonitoring- Den aktiven Stream stoppen.isMonitoring- Stream-Status und Anzahl der ausgegebenen Samples prüfen.removeAllListeners- Alle auf dem Plugin registrierten Listener entfernen.deviceInfoUpdate- Listener-Event, das für jedes periodische Sample ausgegeben wird.
Beispielhafte Verwendung
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);
Metriken in ein Diagramm streamen
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 läuft standardmäßig in 1000-ms-Intervallen, begrenzt Intervalle unter 250 ms und gibt sofort ein Sample aus, es sei denn, Sie setzen emitImmediately: false. Der Aufruf von startMonitoring() startet die aktive Sitzung mit den neuen Optionen neu. Jedes Event enthält seine sequence, startedAt, und elapsedMs.
Nutzt durationMs oder sampleCount automatisch zu stoppen. Wenn du keinen Listener mehr brauchst, rufe await DeviceInfo.removeAllListeners().
Hinweise zu Onboard-Sensoren
Sensorwerte sind optional, da Geräte unterschiedliche Hardware bereitstellen. Android kann Batterietemperatur, Umgebungstemperatur, Luftfeuchtigkeit, Luftdruck, Licht, Näherung und – wenn verfügbar – CPU-/GPU-Thermalzonenwerte im Best-Effort-Verfahren melden. iOS meldet die Verfügbarkeit von CoreMotion-Sensoren, den thermischen Zustand und den Energiesparmodus, aber öffentliche iOS-APIs stellen keine rohen CPU- oder GPU-Temperaturen bereit.
Das Plugin ruft keine Wetterdaten ab. Außentemperatur und Luftfeuchtigkeit erfordern eine separate Integration für Standort und Wetter API.
Vollständige Referenz
Weiter
Wenn du es nutzt @capgo/capacitor-device-info um Diagnose- oder Monitoring-Screens zu erstellen, verbinde es mit @capgo/capacitor-device-info für die Übersicht, Erste Schritte für Installations- und API-Beispiele, @capgo/capacitor-barometer verwenden für dediziertes Druck-Streaming und @capgo/capacitor-light-sensor verwenden für dedizierte Lichtmessungen.