Langsung ke konten utama

Manajer Statistik Penggunaan plugin Capacitor

Akses statistik penggunaan Android untuk melacak durasi penggunaan aplikasi dan analitik screen time

Instal

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

Panduan

Cara menggunakan Usage Stats Manager di Capacitor

Menggunakan @capgo/capacitor-android-usagestatsmanager

Plugin Capacitor untuk mengakses API Android UsageStatsManager.

Instal

bun add @capgo/capacitor-android-usagestatsmanager
bunx cap sync

Apa yang Diekspos Plugin Ini

  • queryAndAggregateUsageStats - Mengkueri dan mengagregasi statistik penggunaan untuk rentang waktu yang diberikan.
  • isUsageStatsPermissionGranted - Memeriksa apakah izin statistik penggunaan telah diberikan.
  • openUsageStatsSettings - Membuka layar pengaturan statistik penggunaan. Ini akan membuka layar pengaturan statistik penggunaan, yang memungkinkan pengguna untuk memberikan izin statistik penggunaan. Ini akan selalu membuka layar pengaturan, bahkan jika izin sudah diberikan.
  • queryAllPackages - Mengkueri semua paket yang terinstal di perangkat. Memerlukan izin QUERY_ALL_PACKAGES.

Contoh Penggunaan

queryAndAggregateUsageStats

Mengkueri dan mengagregasi statistik penggunaan untuk rentang waktu yang diberikan.

import { CapacitorUsageStatsManager } from '@capgo/capacitor-android-usagestatsmanager';

const oneDayAgo = Date.now() - 24 * 60 * 60 * 1000;
const now = Date.now();
const stats = await CapacitorUsageStatsManager.queryAndAggregateUsageStats({
  beginTime: oneDayAgo,
  endTime: now
});

for (const [packageName, usageData] of Object.entries(stats)) {
  console.log(`${packageName}: ${usageData.totalTimeInForeground}ms`);
}

isUsageStatsPermissionGranted

Memeriksa apakah izin statistik penggunaan telah diberikan.

import { CapacitorUsageStatsManager } from '@capgo/capacitor-android-usagestatsmanager';

const { granted } = await CapacitorUsageStatsManager.isUsageStatsPermissionGranted();
if (!granted) {
  await CapacitorUsageStatsManager.openUsageStatsSettings();
}

openUsageStatsSettings

Membuka layar pengaturan statistik penggunaan. Ini akan membuka layar pengaturan statistik penggunaan, yang memungkinkan pengguna untuk memberikan izin statistik penggunaan. Ini akan selalu membuka layar pengaturan, bahkan jika izin sudah diberikan.

import { CapacitorUsageStatsManager } from '@capgo/capacitor-android-usagestatsmanager';

await CapacitorUsageStatsManager.openUsageStatsSettings();

queryAllPackages

Mengkueri semua paket yang terinstal di perangkat. Memerlukan izin QUERY_ALL_PACKAGES.

import { CapacitorUsageStatsManager } from '@capgo/capacitor-android-usagestatsmanager';

const { packages } = await CapacitorUsageStatsManager.queryAllPackages();
packages.forEach(pkg => {
  console.log(`${pkg.appName} (${pkg.packageName}): v${pkg.versionName}`);
});

Referensi Lengkap

Lanjutkan dari menggunakan @capgo/capacitor-android-usagestatsmanager

Jika Anda menggunakan Menggunakan @capgo/capacitor-android-usagestatsmanager untuk merencanakan operasi dashboard dan API, hubungkan dengan @capgo/capacitor-android-usagestatsmanager untuk detail implementasi di @capgo/capacitor-android-usagestatsmanager, Panduan Memulai untuk detail implementasi di Getting Started, Ringkasan API untuk detail implementasi di API Overview, Pendahuluan untuk detail implementasi di Introduction, dan Kunci API untuk detail implementasi di API Keys.

FAQ

FAQ plugin Usage Stats Manager

Bagaimana cara menginstal plugin Usage Stats Manager di aplikasi Capacitor?

Jalankan "bun add @capgo/capacitor-android-usagestatsmanager" (atau "npm install @capgo/capacitor-android-usagestatsmanager"), lalu jalankan "bunx cap sync" agar proyek iOS dan Android mengambil code native. Impor dari "@capgo/capacitor-android-usagestatsmanager" di code aplikasi Anda.

Apakah @capgo/capacitor-android-usagestatsmanager bekerja dengan React, Vue, dan Angular?

Ya. Usage Stats Manager adalah paket Capacitor, jadi bekerja dengan framework web apa pun yang berjalan di dalam Capacitor, termasuk Ionic, React, Vue, Angular, Svelte, dan JavaScript murni.

Versi Capacitor mana yang didukung oleh @capgo/capacitor-android-usagestatsmanager?

Plugin Capgo mengikuti versi mayor Capacitor: gunakan versi mayor plugin yang sesuai dengan versi mayor Capacitor Anda (contoh: plugin v8 dengan Capacitor 8). Tabel kompatibilitas di README GitHub mencantumkan versi yang masih di-maintain.

Apakah @capgo/capacitor-android-usagestatsmanager gratis dan open source?

Ya. code sumber tersedia di GitHub pada https://github.com/Cap-go/capacitor-android-usagestatsmanager/ dan paketnya gratis untuk diinstal dari npm. Laporan bug dan pull request disambut baik.

Bisakah saya memperbarui code yang menggunakan Usage Stats Manager tanpa review App Store?

Instalasi atau upgrade plugin akan mengubah native code, jadi butuh build store baru. Setelah itu, perubahan JavaScript, HTML, dan CSS yang memanggil plugin bisa langsung dikirim lewat live updates Capgo.

Rilis perubahan Usage Stats Manager tanpa menunggu review aplikasi

Setelah plugin ada di build store Anda, live updates Capgo akan mengirim perubahan JavaScript, HTML, dan CSS ke pengguna dalam hitungan menit.

Mulai dengan Capgo