ガイド
Capacitor で Device Info を使う方法
@capgo/capacitor-device-info の使い方
CPU、メモリ、GPU、ストレージ、温度、低電力、オンボードセンサーのメトリクスを Capacitor アプリから読み取ります。
互換性
このプラグインには Capacitor 8以降が必要です（@capacitor/core >=8.0.0).
インストール
npm install @capgo/capacitor-device-info
npx cap sync
このプラグインが提供する機能
getInfo- CPU、メモリ、GPU、ストレージ、サーマルステート、低電力モード、オンボードセンサーを含むスナップショットを1回取得します。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未満の間隔はクランプされ、設定しない限り即座にサンプルが発行されます emitImmediately: falseを送信します。また、 startMonitoring() 新しいオプションでアクティブなセッションを再び再起動します。各イベントにはその sequence, startedAtや elapsedMs.
使用する durationMs または sampleCount 自動的に停止するためのものです。リスナーが不要になった場合は、 await DeviceInfo.removeAllListeners().
Onboard センサーに関する注意点
デバイスによって公開されるハードウェアが異なるため、センサーの読み取り値はオプションです。Android では、利用可能な場合にバッテリー温度、周囲温度、湿度、気圧、照度、近接、およびベストエフォートの CPU/GPU サーマルゾーン値を報告できます。iOS では CoreMotion センサーの可用性、サーマルステート、低電力状態を報告しますが、公開されている iOS API では CPU や GPU の生の温度は取得できません。
このプラグインは天気データを取得しません。外気温や湿度を取得するには、別途位置情報と天気 API の連携が必要です。
完全なリファレンス
次へ進む
使用している場合 @capgo/capacitor-device-info 診断やモニタリング画面を構築するには、以下と連携してください： @capgo/capacitor-device-info 概要については、 スタートガイド インストールと API の例は、 @capgo/capacitor-barometer の使い方 専用の圧力ストリーミング用、および @capgo/capacitor-light-sensor の使用方法 専用の照度測定に。