跳过主要内容
返回插件
@capgo/capacitor-device-info
教程
@capgo/capacitor-device-info

设备信息

从Capacitor应用中读取CPU、内存、GPU、存储、热度状态和内置传感器指标

查看

设备信息教程

在设备上测试

Download the Capgo app, then scan the QR code.

设备信息插件预览二维码 code

使用 @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、存储、温度状态、低功耗模式和主板传感器的快照
  • 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();

- 监控默认为 1000 ms 的间隔,下限为 250 ms,除非您设置 emitImmediately: false- 再次调用 startMonitoring() - 重启活动会话以使用新选项。每个事件都包括其 sequence, startedAt- ,并且 elapsedMs.

- 使用 durationMs - 或 sampleCount - 咨询服务 await DeviceInfo.removeAllListeners().

Onboard sensor notes

设备读数是可选的,因为设备暴露不同的硬件。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 专门用于光线读数