Passer à la navigation principale

Device Info plugin Capacitor

Lisez les métriques de CPU, mémoire, GPU, stockage, état thermique et capteurs embarqués à partir d'applications Capacitor.

Installer

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

Guide

How to use Device Info in Capacitor

Utilisation de @capgo/capacitor-device-info

Lisez les métriques de CPU, mémoire, GPU, stockage, thermique, faible consommation et capteurs embarqués à partir d'une application Capacitor.

Compatibilité

Cette extension nécessite Capacitor 8 ou ultérieur (@capacitor/core >=8.0.0).

Installation

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

Ce que ce plugin expose

  • getInfo Lisez une capture instantanée avec CPU, mémoire, GPU, stockage, état thermique, mode faible consommation et capteurs embarqués.
  • startMonitoring Prenez des captures périodiques pour les tableaux de bord de graphiques et de diagnostics.
  • stopMonitoring Arrêtez la diffusion active.
  • isMonitoring Vérifiez l'état de la diffusion et le nombre d'échantillons émis.
  • removeAllListeners Supprimez tous les écouteurs enregistrés sur le plugin.
  • deviceInfoUpdate Événement émis par chaque sample périodique.

Exemple d'utilisation

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

Flux de métriques dans un graphique

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

La surveillance par défaut utilise un intervalle de 1000 ms, claque les intervalles inférieurs à 250 ms et émet un sample immédiat à moins que vous n'ayez configuré emitImmediately: false. Appeler startMonitoring() redémarrage de la session active avec les nouvelles options. Chaque événement inclut son sequence, startedAt, et elapsedMs.

Utilisez durationMs ou sampleCount redémarrez automatiquement. Si vous n'avez plus besoin de tout listener, appelez await DeviceInfo.removeAllListeners().

Notes de capteur d'abord

Les lectures de capteur sont optionnelles car les appareils exposent différents matériel. Android peut signaler la température de la batterie, la température ambiante, l'humidité, la pression barométrique, la lumière, la proximité et les valeurs de zone thermique CPU/GPU de meilleure volonté lorsque disponibles. iOS signale la disponibilité du capteur CoreMotion, l'état thermique et l'état à faible consommation, mais les API iOS publiques ne révèlent pas la température CPU ou GPU brute.

Le plugin ne récupère pas les données météorologiques. La température extérieure et l'humidité nécessitent une intégration de localisation et de météo API séparée.

Référence complète

Continuez

Si vous utilisez @capgo/capacitor-informations-sur-le-dispositif pour créer des écrans de diagnostics ou de surveillance, connectez-l’avec @capgo/capacitor-informations-sur-le-dispositif pour une vue d'ensemble, Getting Started pour l'installation et les exemples de API Utilisation de @capgo/capacitor-baromètre pour un flux de pression dédié, et Utilisation de @capgo/capacitor-capteur de lumière pour des lectures de lumière dédiées.

FAQ

FAQ du plugin d'informations sur le dispositif

Comment puis-je installer le plugin Device Info dans une application Capacitor ?

Exécutez la commande « bun add @capgo/capacitor-device-info » (ou « npm install @capgo/capacitor-device-info »), puis exécutez « bunx cap sync » afin que les projets iOS et Android prennent en compte les natives code. Importez-l’à partir de « @capgo/capacitor-device-info » dans votre application code.

Le package @capgo/capacitor-device-info fonctionne-t-il avec React, Vue et Angular?

Oui. L'informations sur le dispositif est un package Capacitor, il fonctionne donc avec tout framework web qui s'exécute à l'intérieur de Capacitor, y compris Ionic, React, Vue, Angular, Svelte et JavaScript pur.

Quelle version de Capacitor est prise en charge par @capgo/capacitor-device-info?

Capgo plugins suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à la version majeure de votre Capacitor (par exemple, plugin v8 avec Capacitor 8). La table de compatibilité dans le README du GitHub liste les versions maintenues.

Le package @capgo/capacitor-device-info est-il gratuit et open source?

Oui. Le code source de code est public sur GitHub à l'adresse https://github.com/Cap-go/capacitor-device-info/ et le package est gratuit pour l'installer à partir de npm. Les rapports de bogues et les demandes de modification sont les bienvenus.

Puis-je mettre à jour code qui utilise Device Info sans passer par une revue de l'App Store ?

L'installation ou la mise à niveau du plugin modifie les natives code, il faut donc une nouvelle build de l'application. Une fois cela fait, les modifications JavaScript, HTML et CSS qui appellent le plugin peuvent être déployées instantanément avec les mises à jour Capgo.

Envoyez les modifications de Device Info sans attendre la revue de l'application

Une fois le plugin est dans votre build de magasin, les mises à jour en direct Capgo poussent vos modifications de JavaScript, HTML et CSS vers les utilisateurs en quelques minutes.

Démarrer avec Capgo