Langkahi ke Konten Utama
@capgo/capacitor-info-perangkat API Perangkat Terbuka Sumber

Info Perangkat plugin Capacitor

Baca CPU, memori, GPU, penyimpanan, keadaan panas, dan sensor onboard dari Capacitor aplikasi

Pasang

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

Panduan

Cara menggunakan Informasi Perangkat di Capacitor

Menggunakan @capgo/capacitor-device-info

Baca metrik CPU, memori, GPU, penyimpanan, suhu, energi rendah, dan sensor onboard dari aplikasi Capacitor.

Compatibility

Plugin ini memerlukan Capacitor 8 atau lebih baru (@capacitor/core >=8.0.0).

Instal

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

Apa yang plugin ini terbuka

  • getInfo - Baca satu snapshot dengan CPU, memori, GPU, penyimpanan, kondisi panas, mode rendah daya, dan sensor onboard.
  • startMonitoring - Mulai snapshot berkala untuk dashboard grafik dan diagnostik.
  • stopMonitoring - Berhenti stream aktif.
  • isMonitoring - Periksa status stream dan jumlah sampel yang dikeluarkan.
  • removeAllListeners - Hapus setiap pendengar yang terdaftar pada plugin.
  • deviceInfoUpdate - Event pendengar yang dikeluarkan untuk setiap sampel berkala.

- Contoh penggunaan

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

- Stream metrik ke dalam grafik

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

- Pengawasan defaultnya adalah interval 1000 ms, memadatkan interval di bawah 250 ms, dan mengeluarkan sampel segera kecuali Anda menetapkan emitImmediately: false- . Panggil startMonitoring() restart sesi aktif dengan opsi baru lagi. Setiap event termasuk sequence, startedAt, dan elapsedMs.

Pilih durationMs atau sampleCount untuk menghentikan otomatis. Jika Anda tidak memerlukan listener apa pun lagi, panggil await DeviceInfo.removeAllListeners().

Catatan sensor onboard

Pembacaan sensor optional karena perangkat menampilkan perangkat keras yang berbeda. Android dapat melaporkan suhu baterai, suhu lingkungan, kelembaban, tekanan barometrik, cahaya, keberadaan, dan nilai termal zona CPU/GPU yang dapat diakses ketika tersedia. iOS melaporkan ketersediaan sensor CoreMotion, keadaan termal, dan keadaan rendah daya, tetapi API publik iOS tidak mengekspos suhu CPU atau GPU mentah.

Plugin ini tidak mengambil data cuaca. Suhu luar dan kelembaban memerlukan integrasi lokasi dan cuaca yang terpisah API.

Panduan Lengkap

Teruskan

Jika Anda menggunakan @capgo/capacitor-device-info untuk membangun layar diagnostik atau pemantauan, hubungkannya dengan @capgo/capacitor-device-info untuk ringkasan, Mulai Menggunakan untuk instalasi dan API contoh, Menggunakan @capgo/capacitor-barometer untuk aliran tekanan khusus, dan Menggunakan @capgo/capacitor-light-sensor untuk bacaan cahaya khusus.

FAQ

FAQ Plugin Informasi Perangkat

Bagaimana cara saya menginstal plugin Informasi Perangkat di sebuah aplikasi Capacitor?

Jalankan "bun add @capgo/capacitor-device-info" (atau "npm install @capgo/capacitor-device-info"), kemudian jalankan "bunx cap sync" agar proyek iOS dan Android dapat menangkap native code. Import dari "@capgo/capacitor-device-info" di aplikasi code.

Apakah @capgo/capacitor-device-info berfungsi dengan React, Vue dan Angular?

Ya. Informasi Perangkat adalah sebuah Capacitor package, sehingga berfungsi dengan semua framework web yang berjalan di Capacitor, termasuk Ionic, React, Vue, Angular, Svelte dan JavaScript biasa.

Versi Capacitor mana yang didukung oleh @capgo/capacitor-device-info?

Capgo plugin mengikuti versi utama Capacitor: gunakan versi plugin utama yang sesuai dengan versi utama Capacitor (misalnya plugin v8 dengan Capacitor 8). Tabel kompatibilitas di README GitHub menampilkan versi yang dipelihara.

Apakah @capgo/capacitor-device-info gratis dan terbuka sumber?

Ya. Sumber code yang terbuka tersedia di GitHub di https://github.com/Cap-go/capacitor-device-info/ dan paketnya dapat diinstal secara gratis dari npm. Laporan bug dan permintaan pull diterima.

Dapatkah saya memperbarui code yang menggunakan Informasi Perangkat tanpa melalui tinjauan App Store?

Menginstal atau mengupgrade plugin mengubah native code, sehingga memerlukan pembuatan aplikasi baru. Setelah itu, perubahan JavaScript, HTML dan CSS yang memanggil plugin dapat dikirimkan secara instan dengan Capgo live updates.

Kirim perubahan Device Info tanpa menunggu tinjauan aplikasi

Setelah plugin masuk dalam pembangunan toko Anda, Capgo pembaruan hidup memindahkan perubahan JavaScript, HTML, dan CSS Anda ke pengguna dalam menit.

Mulai dengan Capgo