ガイド
Capacitor で Usage Stats Manager を使う方法
@capgo/capacitor-android-usagestatsmanager の使用方法
Android の UsageStatsManager API にアクセスするための Capacitor プラグイン
インストール
bun add @capgo/capacitor-android-usagestatsmanager
bunx cap sync
このプラグインで利用可能な機能
queryAndAggregateUsageStats- 指定された期間の使用統計をクエリして集計します。isUsageStatsPermissionGranted- 使用統計の権限が許可されているか確認します。openUsageStatsSettings- 使用統計の設定画面を開きます。ユーザーが使用統計の権限を許可できるよう設定画面を表示します。権限が既に許可されていても、必ず設定画面が開きます。queryAllPackages- デバイスにインストールされているすべてのパッケージを照会します。QUERY_ALL_PACKAGES 権限が必要です。
使用例
queryAndAggregateUsageStats
指定された期間の利用統計を照会し、集計します。
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
利用統計の権限が許可されているか確認します。
import { CapacitorUsageStatsManager } from '@capgo/capacitor-android-usagestatsmanager';
const { granted } = await CapacitorUsageStatsManager.isUsageStatsPermissionGranted();
if (!granted) {
await CapacitorUsageStatsManager.openUsageStatsSettings();
}
openUsageStatsSettings
利用統計の設定画面を開きます。ユーザーが利用統計の権限を許可できるように設定画面を表示します。権限が既に許可されている場合でも、必ず設定画面が開きます。
import { CapacitorUsageStatsManager } from '@capgo/capacitor-android-usagestatsmanager';
await CapacitorUsageStatsManager.openUsageStatsSettings();
queryAllPackages
- デバイスにインストールされているすべてのパッケージを照会します。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}`);
});
リファレンス全文
- GitHub: https://github.com/Cap-go/capacitor-android-usagestatsmanager/
- ドキュメント: /docs/plugins/android-usagestatsmanager/
@capgo/capacitor-android-usagestatsmanager の使用方法へ
使用している場合 @capgo/capacitor-android-usagestatsmanager の使用方法 ダッシュボードと API の運用を計画するには、これを次と連携させます @capgo/capacitor-android-usagestatsmanager @capgo/capacitor-android-usagestatsmanager の実装詳細については、 スタートガイド スタートガイドの実装詳細については、 API の概要 「API の概要」の実装の詳細については、 はじめに はじめにの実装詳細、および API キー API Keys の実装詳細については、