Inicio

Instalar

Puede utilizar nuestra configuración asistida por IA para instalar el plugin. Agregue las Capgo habilidades a su herramienta de IA utilizando el siguiente comando:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Luego utilice el siguiente prompt:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-device-info` plugin in my project.

Si prefieres la configuración manual, instala el plugin ejecutando los siguientes comandos y sigue las instrucciones específicas de la plataforma a continuación:

bun add @capgo/capacitor-device-info
bunx cap sync

Importar

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

Leer una instantánea

const snapshot = await DeviceInfo.getInfo();

console.log(snapshot.cpu.cores);
console.log(snapshot.memory.usedPercent);
console.log(snapshot.storage.freeBytes);
console.log(snapshot.sensors?.pressureHpa);

cpu.usagePercent es basado en deltas. La primera muestra nativa puede omitirlo; llama getInfo de nuevo más tarde o utiliza la monitorización para recibir el uso de CPU poblado después de la segunda muestra.

Actualizaciones en vivo

const handle = await DeviceInfo.addListener('deviceInfoUpdate', (sample) => {
  console.log(sample.sequence, sample.elapsedMs);
  console.log(sample.cpu.usagePercent);
  console.log(sample.sensors?.readings);
});

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

Detener actualizaciones

await DeviceInfo.stopMonitoring();
await handle.remove();

También puedes detener automáticamente:

await DeviceInfo.startMonitoring({
  intervalMs: 1000,
  durationMs: 60_000,
  sampleCount: 60,
});

Verificar estado de monitoreo

const state = await DeviceInfo.isMonitoring();

if (state.monitoring) {
  console.log(state.samplesEmitted);
}

Iniciar campos de sensores

const { sensors, cpu, gpu } = await DeviceInfo.getInfo();

console.log(cpu.temperatureCelsius);
console.log(gpu?.temperatureCelsius);
console.log(sensors?.batteryTemperatureCelsius);
console.log(sensors?.ambientTemperatureCelsius);
console.log(sensors?.relativeHumidityPercent);
console.log(sensors?.pressureHpa);
console.log(sensors?.illuminanceLux);
console.log(sensors?.proximityDistanceCm);
console.log(sensors?.availableSensors);

Los campos de sensores son opcionales. Solo están presentes cuando el dispositivo, el sistema operativo y el entorno de la aplicación expone ese métrica.

Notas de la plataforma

• iOS no requiere permisos para las métricas expuestas. Informa la disponibilidad de sensores de movimiento Core pero no la temperatura de CPU o GPU en bruto.
• Android no requiere permisos para las métricas expuestas. Las temperaturas de CPU y GPU son lecturas de zona térmica de mejor esfuerzo.
• El soporte web es de mejor esfuerzo y informa arrays de sensores de borda vacíos porque los navegadores no exponen sensores de dispositivo nativos consistentemente.

Referencia de tipo

DeviceInfoSnapshot

export interface DeviceInfoSnapshot {
  timestamp: number;
  platform: 'ios' | 'android' | 'web';
  cpu: CpuInfo;
  memory: MemoryInfo;
  storage: StorageInfo;
  gpu?: GpuInfo;
  thermalState?: ThermalState;
  lowPowerMode?: boolean;
  sensors?: OnboardSensorsInfo;
}

OnboardSensorsInfo

export interface OnboardSensorsInfo {
  availableSensors?: OnboardSensorDescriptor[];
  readings?: OnboardSensorReading[];
  batteryTemperatureCelsius?: number;
  ambientTemperatureCelsius?: number;
  relativeHumidityPercent?: number;
  pressureHpa?: number;
  illuminanceLux?: number;
  proximityDistanceCm?: number;
}

MonitoringOptions

export interface MonitoringOptions {
  intervalMs?: number;
  durationMs?: number;
  sampleCount?: number;
  emitImmediately?: boolean;
}

Fuente de Verdad

Esta página se genera a partir del plugin’s src/definitions.tsRe-ejecutar la sincronización cuando el público API cambie en la fuente

Sigue adelante desde Getting Started

Si estás utilizando Inicio rápido para diagnosticar dispositivos, conecte con @capgo/capacitor-device-info para una visión general, Usando @capgo/capacitor-device-info para un tutorial, @capgo/capacitor-barometer para lecturas de presión enfocadas, y @capgo/capacitor-light-sensor para lecturas del sensor de luz enfocadas.