@capgo/capacitor-android-usagestatsmanagerを使用

Capacitorプラグインは、Androidの使用統計管理APIにアクセスするために使用されます。

インストール

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 UsageStatsManager.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 UsageStatsManager.isUsageStatsPermissionGranted();
if (!granted) {
  await UsageStatsManager.openUsageStatsSettings();
}

`openUsageStatsSettings`

使用統計設定画面を開きます。この設定画面を開くと、ユーザーが使用統計の許可を付与することができます。この設定画面は、許可が既に付与されている場合でも常に開きます。

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

await UsageStatsManager.openUsageStatsSettings();

`queryAllPackages`

デバイス上にインストールされているすべてのパッケージを照会します。QUERY_ALL_PACKAGES許可が必要です。

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

const { packages } = await UsageStatsManager.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/

Keep going from Using @capgo/capacitor-android-usagestatsmanager

Capacitor Android UsageStatsManager を使用している場合 Using @capgo/capacitor-android-usagestatsmanager to plan dashboard and API operations, connect it with @capgo/capacitor-android-usagestatsmanager Capacitor-Android-UsageStatsManagerの実装詳細については@capgo/capacitor-android-usagestatsmanagerを参照してください。はじめに Capacitor-Android-UsageStatsManagerの実装詳細についてはGetting Startedを参照してください。 APIの概要 Capacitor-Android-UsageStatsManagerの実装詳細についてはAPI Overviewを参照してください。はじめに Capacitor-Android-UsageStatsManagerの実装詳細についてはIntroductionを参照してください。 APIのキー Capacitor-Android-UsageStatsManagerの実装詳細についてはAPI Keysを参照してください。

使用状況マネージャー

ガイド