@capgo/capacitor-android-usagestatsmanager

Ringkasan

Plugin Capacitor Android Usage Stats Manager mengekspos UsageStatsManager SDK Android ke aplikasi Capacitor, memungkinkan akses ke statistik penggunaan aplikasi terperinci dan data penggunaan perangkat. Plugin ini memungkinkan developer untuk melacak pola penggunaan aplikasi, waktu layar, dan analitik perilaku pengguna di perangkat Android.

Statistik penggunaan

Akses data UsageStatsManager SDK Android 📱

Pemantauan aplikasi

Lacak waktu dan frekuensi penggunaan aplikasi individual 🕐

Manajemen izin

Tangani izin statistik penggunaan dengan mulus 🛡️

Informasi paket

Query detail dan metadata paket yang terinstal 📦

Instalasi

npm install @capgo/capacitor-android-usagestatsmanager
npx cap sync

Izin yang Diperlukan

Tambahkan izin ini ke android/app/src/main/AndroidManifest.xml Anda:

<uses-permission android:name="android.permission.PACKAGE_USAGE_STATS" />
<uses-permission android:name="android.permission.QUERY_ALL_PACKAGES" />

Metode API Inti

Statistik Penggunaan

• queryAndAggregateUsageStats(options) - Ambil statistik penggunaan terperinci untuk aplikasi yang terinstal
• isUsageStatsPermissionGranted() - Periksa apakah izin statistik penggunaan diberikan
• openUsageStatsSettings() - Buka pengaturan sistem untuk izin statistik penggunaan

Informasi Paket

• queryAllPackages() - Dapatkan informasi tentang semua paket yang terinstal

Contoh Penggunaan

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

// Check if permission is granted
const permissionResult = await AndroidUsageStatsManager.isUsageStatsPermissionGranted();
if (!permissionResult.granted) {
  // Open settings to grant permission
  await AndroidUsageStatsManager.openUsageStatsSettings();
  return;
}

// Query usage statistics
const statsOptions = {
  intervalType: 0, // INTERVAL_DAILY
  startTime: Date.now() - (7 * 24 * 60 * 60 * 1000), // 7 days ago
  endTime: Date.now()
};

const usageStats = await AndroidUsageStatsManager.queryAndAggregateUsageStats(statsOptions);
console.log('Usage statistics:', usageStats);

// Get all installed packages
const packages = await AndroidUsageStatsManager.queryAllPackages();
console.log('Installed packages:', packages);

Penanganan Izin

Plugin memerlukan izin khusus yang tidak dapat diberikan melalui permintaan izin runtime normal:

1. PACKAGE_USAGE_STATS: Memungkinkan akses ke statistik penggunaan
2. QUERY_ALL_PACKAGES: Diperlukan untuk informasi paket (Android 11+)

Pengguna harus memberikan izin ini secara manual melalui pengaturan sistem. Gunakan openUsageStatsSettings() untuk mengarahkan pengguna ke halaman pengaturan yang sesuai.

Tipe Data

Statistik Penggunaan

• Waktu dan frekuensi penggunaan aplikasi
• Waktu pertama dan terakhir digunakan
• Total waktu di foreground
• Jumlah peluncuran

Informasi Paket

• Nama paket dan versi
• Waktu instalasi
• Label dan ikon aplikasi
• Aplikasi sistem vs pengguna

Kasus Penggunaan

• Aplikasi kesejahteraan digital: Pantau waktu layar dan penggunaan aplikasi
• Kontrol orang tua: Lacak penggunaan perangkat anak-anak
• Aplikasi produktivitas: Analisis pola kerja dan waktu fokus
• Analitik: Pahami perilaku pengguna dan keterlibatan aplikasi

Kompatibilitas Android

• Versi Android minimum: API level 21 (Android 5.0)
• Fitur lanjutan: API level 29+ (Android 10+) untuk statistik yang ditingkatkan
• Query paket: API level 30+ (Android 11+) memerlukan QUERY_ALL_PACKAGES

Pertimbangan Keamanan

• Izin statistik penggunaan bersifat sensitif dan memerlukan persetujuan pengguna
• Pertimbangkan privasi pengguna saat mengumpulkan data penggunaan
• Implementasikan praktik penanganan dan penyimpanan data yang tepat
• Ikuti kebijakan Google Play untuk pengumpulan data penggunaan

Dokumentasi

Lihat dokumentasi lengkap untuk panduan implementasi terperinci dan pola penggunaan lanjutan.