使用状況管理プラグイン

Capacitorの@capgo/capacitor-android-usagestatsmanagerを使用

Capacitor plugin for accessing Android UsageStatsManager 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/__CAPGO_KEEP_1__-android-usagestatsmanager/

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

__CAPGO_KEEP_0__を使用している場合 Using @capgo/capacitor-android-usagestatsmanager APIと連携して、ダッシュボードとAPIの運用計画を行う @capgo/capacitor-android-usagestatsmanager capgoの実装詳細は、@capgo/capacitor-android-usagestatsmanager 実装詳細は、@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-android-usagestatsmanager Getting Started API Overview 実装詳細については API の概要を参照してください。 概要 実装詳細については Introduction を参照してください。 API のキーコンセプト 実装詳細については API Keys を参照してください。