使用状況統計管理プラグインの使用 (@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/

Capgoを使用して続きましょう: @capgo/capacitor-android-usagestatsmanager

Capgoを使用している場合 @capgo/capacitor-android-usagestatsmanager Capgoを使用してダッシュボードとAPIの計画を立てる場合、@API/__CAPGO_KEEP_1__-android-usagestatsmanagerと接続してください Capgoを使用して続きましょう: @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の概要 Capacitor-Android-UsageStatsManagerの実装詳細についてはIntroductionを参照してください。 APIのキー Capacitor-Android-UsageStatsManagerの実装詳細についてはAPI Keysを参照してください。

使用状況マネージャー

ガイド