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 - Mengambil dan mengagregasi statistik penggunaan untuk rentang waktu tertentu.
  • isUsageStatsPermissionGranted - Memeriksa apakah izin statistik penggunaan sudah diberikan.
  • openUsageStatsSettings Buka layar pengaturan statistik penggunaan. Ini akan membuka layar pengaturan agar pengguna dapat memberikan izin statistik penggunaan. Layar pengaturan akan selalu terbuka, meskipun izin sudah diberikan.
  • queryAllPackages - Mengambil semua paket yang terinstal di perangkat. Memerlukan izin QUERY_ALL_PACKAGES.

Contoh Penggunaan

queryAndAggregateUsageStats

Mengambil dan mengagregasi statistik penggunaan untuk rentang waktu tertentu.

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 sudah diberikan.

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

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

openUsageStatsSettings

Buka layar pengaturan statistik penggunaan. Ini akan membuka layar pengaturan agar pengguna dapat memberikan izin statistik penggunaan. Layar pengaturan akan selalu terbuka, meskipun izin sudah diberikan.

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

await CapacitorUsageStatsManager.openUsageStatsSettings();

queryAllPackages

Mengambil 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

Lanjut ke 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 install 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 mendeteksi code native. Import dari "@capgo/capacitor-android-usagestatsmanager" di dalam code aplikasi Anda.

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

Ya. Usage Stats Manager adalah package Capacitor, jadi bisa digunakan dengan framework web apa pun yang berjalan di dalam Capacitor, termasuk Ionic, React, Vue, Angular, Svelte, dan JavaScript biasa.

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. Source code tersedia secara publik di GitHub pada https://github.com/Cap-go/capacitor-android-usagestatsmanager/ dan package ini gratis untuk diinstall dari npm. Laporan bug dan pull request sangat kami terima.

Bisakah saya update 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