使用状況統計管理プラグインの使用 (@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: github.com/Cap-go/capacitor-android-usagestatsmanager
ドキュメント: /docs/plugins/android-usagestatsmanager/

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

__CAPGO_KEEP_0__を使用して計画ダッシュボードと__CAPGO_KEEP_0__の操作を行う場合、@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-android-usagestatsmanagerと接続してください。 capgoを使用して計画ダッシュボードとcapgoの操作を行う場合、@capgo/capacitor-android-usagestatsmanagerと接続してください。 to plan dashboard and API operations, connect it with @capgo/capacitor-android-usagestatsmanager Capacitor-Android-UsageStatsManagerの実装詳細については@capgo/capacitor-android-usagestatsmanagerを参照してください。 Getting Started Capacitor-Android-UsageStatsManagerの実装詳細についてはGetting Startedを参照してください。 API Overview for the implementation detail in API Overview, Capacitor-Android-UsageStatsManagerの導入 Capacitor-Android-UsageStatsManagerの実装詳細についてはCapacitor-Android-UsageStatsManagerの導入を参照してください。 API Keys for the implementation detail in API Keys.

使用状況管理

Usage Stats Managerのチュートリアル