Getting Started

설치 단계와 이 플러그인의 전체 마크다운 가이드를 포함한 설정 프롬프트를 복사하세요.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-device-info`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/device-info/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

호환성

@capgo/capacitor-device-info requires Capacitor 8 이상이 필요합니다 (@capacitor/core >=8.0.0).

설치

You can use our AI-Assisted Setup to install the plugin. Add the Capgo skills to your AI tool using the following command:

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

다음 명령어를 사용하세요:

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

수동 설치를 위해 패키지를 설치하고 네이티브 프로젝트를 동기화하세요:

npm install @capgo/capacitor-device-info
npx cap sync

import

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.storage.freeBytes);
console.log(snapshot.sensors?.pressureHpa);

cpu.usagePercent delta 기반입니다. 첫 번째 원시 샘플은 생략할 수 있습니다; 두 번째 샘플 이후 CPU 사용률이 채워진 것을 받으려면 다시 호출하거나 getInfo() 다시 호출하거나-monitoring을 사용하여 두 번째 샘플 이후 CPU 사용률이 채워진 것을 받으려면

스트림 업데이트

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

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

console.log(session.intervalMs, session.startedAt);

모니터링 동작

intervalMs 밀리초입니다. 아래 1000 밀리초는 250 기본값으로 250.
emitImmediately 밀리초 true.
설정 durationMs 또는 sampleCount 설정 또는
자동으로 모니터링을 중지합니다. startMonitoring() 호출
활성화된 모니터링 중에 다시 시작하면 새로운 옵션과 함께 세션을 재시작합니다. deviceInfoUpdate 모든 sequence1부터 시작하는 startedAt , 세션의 elapsedMs.

타임스탬프, 그리고

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

// Or remove every listener registered on this plugin:
await DeviceInfo.removeAllListeners();

모니터링 상태 확인

const state = await DeviceInfo.isMonitoring();

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

센서 field onboard

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);

플랫폼 설명

Android는 노출된 메트릭에 대한 권한이 필요하지 않습니다. CPU 및 GPU 온도는 최선의 노력으로 열 영역 읽기입니다.
웹 지원은 최선의 노력이며 브라우저가 원시 기기 센서를 일관되게 노출하지 않기 때문에 빈 onboard 센서 배열을 보고합니다.
Copy to clipboard

API reference

메서드	반환	주의
`getInfo()`	`Promise<DeviceInfoSnapshot>`	일시적인 스냅샷을 읽습니다.
`startMonitoring(options?)`	`Promise<StartMonitoringResult>`	주기적인 스냅샷을 시작하거나, 활성 세션을 새로운 옵션으로 재시작합니다.
`stopMonitoring()`	`Promise<StopMonitoringResult>`	활성 세션을 중지합니다.
`isMonitoring()`	`Promise<MonitoringState>`	현재 세션 상태를 반환합니다.
`addListener('deviceInfoUpdate', listener)`	`Promise<PluginListenerHandle>`	주기적인 스냅샷 리스너를 등록합니다.
`removeAllListeners()`	`Promise<void>`	등록된 모든 리스너를 제거합니다.
`getPluginVersion()`	`Promise<PluginVersionResult>`	네이티브 플러그인 버전을 읽습니다.

PluginListenerHandle Capgo에서 제공하는 Capacitor은 remove() 해당 개별 리스너를 제거하는 데

Snapshot 종류

interface CpuInfo {
  cores: number;
  activeCores?: number;
  architecture?: string;
  model?: string;
  usagePercent?: number | null;
  maxFrequencyHz?: number;
  temperatureCelsius?: number;
}

interface MemoryInfo {
  totalBytes?: number;
  freeBytes?: number;
  usedBytes?: number;
  usedPercent?: number;
  appUsedBytes?: number;
  appLimitBytes?: number;
  lowMemory?: boolean;
  pressure?: 'normal' | 'warning' | 'critical' | 'unknown';
}

interface StorageInfo {
  totalBytes?: number;
  freeBytes?: number;
  usedBytes?: number;
  usedPercent?: number;
}

interface GpuInfo {
  api?: 'metal' | 'opengl' | 'webgl' | 'unknown';
  vendor?: string;
  renderer?: string;
  version?: string;
  maxTextureSize?: number;
  temperatureCelsius?: number;
}

type ThermalState = 'nominal' | 'fair' | 'serious' | 'critical' | 'unknown';

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

크기 단위는 바이트이며, maxFrequencyHz 은 헤르츠이며, 온도 값은 섭씨입니다. usagePercent 까지 측정할 수 있습니다. null 센서 종류

Section titled “Sensor types”

interface OnboardSensorDescriptor {
  type: string;
  name?: string;
  vendor?: string;
  platformType?: number;
  maximumRange?: number;
  resolution?: number;
  powerMilliamp?: number;
  minDelayMicroseconds?: number;
  wakeUp?: boolean;
}

interface OnboardSensorReading {
  type: string;
  unit: string;
  value: number;
  name?: string;
  timestamp?: number;
}

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

Unix 시간대는 밀리초로 표시됩니다. 일반적인 단위는 섭씨, 백분율, hPa, 라っく스, 센티미터입니다.

모니터링 유형

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

interface StartMonitoringResult {
  monitoring: boolean;
  intervalMs: number;
  startedAt: number;
}

interface StopMonitoringResult {
  monitoring: boolean;
}

interface MonitoringState {
  monitoring: boolean;
  intervalMs?: number;
  startedAt?: number;
  samplesEmitted?: number;
}

interface DeviceInfoUpdate extends DeviceInfoSnapshot {
  sequence: number;
  startedAt: number;
  elapsedMs: number;
}

interface PluginVersionResult {
  version: string;
}

startedAt, timestamp, elapsedMs 밀리초입니다. sequence 모니터링 세션 1 실질적인 출처

실질적인 출처

This reference follows the public API in the plugin’s src/definitions.ts을 따릅니다. 플러그인의 출처가 변경되면 이 페이지를 업데이트하세요.

시작하기에서 계속

이러한 기능을 사용하고 있다면 시작하기 디바이스 디아그노스틱을 위해 Capacitor@capgo/capacitor-device-info Capacitor@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-device-info Capacitor@capgo/capacitor-barometer Capacitor@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-light-sensor Capacitor@capgo/capacitor-device-info Capacitor@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-barometer Capacitor@capgo/capacitor-light-sensor 광센서 데이터를 위한 집중된 빛 센서 읽기.