使用統計管理プラグインの使用 (@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/__CAPGO_KEEP_1__-android-usagestatsmanagerと接続してください @capgo/capacitor-android-usagestatsmanager Capacitor Android UsageStatsManager の実装詳細については @capgo/capacitor-android-usagestatsmanager を参照してください。 Getting Started Capacitor Android UsageStatsManager の実装詳細については Getting Started を参照してください。 API の概要 Capacitor Android UsageStatsManager の実装詳細については API の概要を参照してください。 Capacitor Android UsageStatsManager の概要 Capacitor Android UsageStatsManager の実装詳細については Introduction を参照してください。 API のキー Capacitor Android UsageStatsManager の実装詳細については API のキーを参照してください。

Usage Stats Manager

ガイド