가이드
Capacitor에서 Device Info 사용법
@capgo/capacitor-device-info 사용하기
Capacitor 앱에서 CPU, 메모리, GPU, 저장소, 열, 저전력 및 온보드 센서 메트릭을 읽습니다.
호환성
이 플러그인은 Capacitor 8 이상을 요구합니다 (@capacitor/core >=8.0.0).
설치
npm install @capgo/capacitor-device-info
npx cap sync
이 플러그인이 노출하는 기능
getInfo- CPU, 메모리, GPU, 저장소, 열 상태, 저전력 모드 및 온보드 센서의 스냅샷을 한 번 읽습니다.startMonitoring- 차트 및 진단 대시보드를 위해 주기적 스냅샷을 시작합니다.stopMonitoring- 활성 스트림을 중지합니다.isMonitoring- 스트림 상태와 방출된 샘플 수를 확인합니다.removeAllListeners- 플러그인에 등록된 모든 리스너를 제거합니다.deviceInfoUpdate- 각 주기적 샘플마다 방출되는 리스너 이벤트.
사용 예시
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);
메트릭을 차트로 스트리밍
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();
모니터링은 기본적으로 1000ms 간격을 사용하며, 250ms 미만 간격은 250ms로 제한하고, 설정하지 않는 한 즉시 샘플을 방출합니다. emitImmediately: false. 다시 호출하면 startMonitoring() 새 옵션으로 활성 세션이 다시 시작됩니다. 각 이벤트에는 해당 sequence, startedAt, 그리고 elapsedMs.
사용 durationMs 또는 sampleCount 자동으로 중지하려면. 더 이상 리스너가 필요하지 않으면 호출하세요 await DeviceInfo.removeAllListeners().
온보드 센서 참고 사항
기기마다 하드웨어가 다르므로 센서 측정값은 선택 사항입니다. Android는 사용 가능한 경우 배터리 온도, 주변 온도, 습도, 기압, 조도, 근접 센서, 그리고 best-effort 방식의 CPU/GPU thermal-zone 값을 보고할 수 있습니다. iOS는 CoreMotion 센서 가용성, thermal state, 저전력 상태를 보고하지만, 공개 iOS API는 raw CPU/GPU 온도를 노출하지 않습니다.
이 플러그인은 날씨 데이터를 가져오지 않습니다. 외부 온도 및 습도를 확인하려면 별도의 위치 및 날씨 API 연동이 필요합니다.
전체 레퍼런스
계속하기
사용 중이라면 @capgo/capacitor-device-info 진단 또는 모니터링 화면을 만들려면 다음과 연결하세요 @capgo/capacitor-device-info 개요는, 시작하기 설치 및 API 예제 보기, @capgo/capacitor-barometer 사용하기 전용 압력 스트리밍과 @capgo/capacitor-light-sensor 사용하기 전용 광도 측정을 위해.