跳过主要内容

设备信息 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 中使用设备信息

使用 @capgo/capacitor-device-info

从 Capacitor 应用程序中读取 CPU、内存、GPU、存储、温度、低功耗和 onboard 传感器指标。

兼容性

此插件需要 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, and elapsedMs.

使用 durationMs 或 sampleCount 自动停止。若无需任何监听器,请调用 await DeviceInfo.removeAllListeners().

停止自动。如需不再需要任何监听器,请调用

设备上载感知笔记

该插件不会获取天气数据。外部温度和湿度需要单独的位置和天气API集成。

该插件不获取天气数据。外部温度和湿度需要单独的位置和天气__CAPGO_KEEP_0__集成。

继续

如果您正在使用 @capgo/capacitor设备信息 用于构建诊断或监控屏幕的插件,连接到 @capgo/capacitor设备信息 获取开始 获取安装和__CAPGO_KEEP_0__示例 使用@API/__CAPGO_KEEP_1__-barometer 使用@capgo/capacitor-气压计 使用@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-light-sensor 使用@capgo/capacitor光感光传感器 If you are using

常见问题

设备信息插件FAQ

如何在Capacitor应用中安装设备信息插件?

运行"bun add @capgo/capacitor-device-info" (或"npm install @capgo/capacitor-device-info"),然后运行"bunx cap sync"以便iOS和Android项目获取native code。从"@capgo/capacitor-device-info"导入到应用code中。

是否支持@capgo/capacitor-device-info与React、Vue和Angular?

是。设备信息是一个Capacitor包,因此它与任何运行在Capacitor中的web框架都兼容,包括Ionic、React、Vue、Angular、Svelte和普通JavaScript。

哪个Capacitor版本支持@capgo/capacitor-device-info?

Capgo插件遵循Capacitor的主要版本:使用与Capacitor主要版本匹配的插件主要版本(例如插件v8与Capacitor 8)。在GitHub README中列出的维护版本的兼容性表格。

是否支持@capgo/capacitor-device-info?

是。设备信息的源code在GitHub上公开可见于https://github.com/Cap-go/capacitor-device-info/,并且该包可以从npm免费安装。欢迎bug报告和pull请求。

是否可以在不经过App Store审查的情况下更新code?

安装或升级插件会更改native code,因此需要一个新的商店构建。之后,JavaScript、HTML和CSS更改可以立即通过Capgo实时更新发布。

不必等待应用程序审查即可将设备信息更改

一旦插件在您的商店构建中,Capgo 即刻将您的 JavaScript、HTML 和 CSS 更改推送给用户。

开始使用 Capgo