ガイド
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/
Using @capgo/capacitor-android-usagestatsmanager から続きを読む
使用している場合 @capgo/capacitor-android-usagestatsmanager の使い方 ダッシュボードと API の運用を計画するには、これを次と連携させます @capgo/capacitor-android-usagestatsmanager @capgo/capacitor-android-usagestatsmanager の実装詳細については、 スタートガイド スタートガイドの実装詳細については、 API の概要 「API の概要」の実装の詳細については、 はじめに はじめにの実装詳細、および API キー API Keys の実装詳細については、