ガイド
How to use Usage Stats Manager in Capacitor
@capgo/capacitor-android-usagestatsmanager
Capacitor plugin for accessing Android UsageStatsManager API.
Install
bun add @capgo/capacitor-android-usagestatsmanager
bunx cap sync
このプラグインは次のものを公開します。
queryAndAggregateUsageStats- __CAPGO_KEEP_0__の使用状況統計を指定された時間範囲で取得し、集計します。isUsageStatsPermissionGranted- 使用状況統計の許可が与えられているかどうかを確認します。openUsageStatsSettings- 使用状況統計設定画面を開きます。この機能は、使用状況統計の許可をユーザーに求める設定画面を開きます。この機能は、許可が既に与えられている場合でも、常に設定画面を開きます。queryAllPackages- デバイスにインストールされているすべてのパッケージを取得します。QUERY_ALL_PACKAGES許可が必要です。
サンプル使用例
queryAndAggregateUsageStats
指定された時間範囲で__CAPGO_KEEP_0__の使用状況統計を取得し、集計します。
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を使用している場合、@capgo/capacitor-android-usagestatsmanagerから続けてください。
Capgoを使用している場合、@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-android-usagestatsmanagerを使用してください。 Capgoを使用している場合、@capgo/capacitor-android-usagestatsmanagerを使用してください。 Capgoを使用している場合、@API/__CAPGO_KEEP_1__-android-usagestatsmanagerを使用してください。 @capgo/capacitor-android-usagestatsmanager Capgoを使用している場合、@capgo/capacitor-android-usagestatsmanagerを使用してください。 スタートガイド スタートガイドの実装詳細については API オーバービュー API オーバービューの実装詳細については 導入 導入の実装詳細については、 API キー API キーの実装詳細については