본문 바로가기
@capgo/capacitor-device-info Device API 오픈 소스

기기 정보 Capacitor 플러그인

Capacitor 앱에서 CPU, 메모리, GPU, 저장소, 열 상태 및 온보드 센서 메트릭을 읽습니다

설치

bun add @capgo/capacitor-device-info bunx cap sync
npm, pnpm 또는 yarn
  • npm install @capgo/capacitor-device-info
  • pnpm add @capgo/capacitor-device-info
  • yarn add @capgo/capacitor-device-info

가이드

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 사용하기 전용 광도 측정을 위해.

자주 묻는 질문

Device Info 플러그인 FAQ

Capacitor 앱에 Device Info 플러그인을 어떻게 설치하나요?

"bun add @capgo/capacitor-device-info"(또는 "npm install @capgo/capacitor-device-info")를 실행한 다음 "bunx cap sync"를 실행해 iOS와 Android 프로젝트가 네이티브 code를 가져오도록 하세요. 앱 code에서 "@capgo/capacitor-device-info"로부터 import 하면 됩니다.

React, Vue, Angular에서 @capgo/capacitor-device-info가 동작하나요?

네. Device Info는 Capacitor 패키지이므로 Ionic, React, Vue, Angular, Svelte, 순수 JavaScript를 포함해 Capacitor 안에서 실행되는 모든 웹 프레임워크와 호환됩니다.

@capgo/capacitor-device-info은 어떤 Capacitor 버전을 지원하나요?

Capgo 플러그인은 Capacitor의 메이저 버전을 따릅니다. 사용 중인 Capacitor 메이저 버전과 일치하는 플러그인 메이저 버전을 사용하세요 (예: Capacitor 8에는 플러그인 v8). 유지 관리되는 버전은 GitHub README의 호환성 표에서 확인할 수 있습니다.

@capgo/capacitor-device-info는 무료이며 오픈 소스인가요?

네. code 소스 코드는 GitHub의 https://github.com/Cap-go/capacitor-device-info/에 공개되어 있고, npm에서 무료로 설치할 수 있습니다. 버그 리포트와 pull request는 언제나 환영합니다.

App Store 심사 없이 Device Info를 사용하는 code를 업데이트할 수 있나요?

플러그인을 설치하거나 업그레이드하면 네이티브 code가 변경되므로 새로운 스토어 빌드가 필요합니다. 그 이후에는 플러그인을 호출하는 JavaScript, HTML, CSS 변경 사항을 Capgo live updates로 즉시 배포할 수 있습니다.

앱 리뷰 대기 없이 Device Info 변경 사항을 배포하세요

스토어 빌드에 플러그인이 포함되면, Capgo live updates로 JavaScript, HTML, CSS 변경 사항을 몇 분 만에 사용자에게 푸시할 수 있습니다.

Capgo로 시작하기