@capgo/capacitor-android-usagestatsmanager

Capacitor plugin for accessing Android UsageStatsManager API.

Install

bun add @capgo/capacitor-android-usagestatsmanager
bunx cap sync

What This Plugin Exposes

queryAndAggregateUsageStats - __CAPGO_KEEP_2__と__CAPGO_KEEP_3__の使用状況統計を指定された時間範囲で取得し統計します。
isUsageStatsPermissionGranted - 使用状況統計の許可が与えられているかどうかを確認します。
openUsageStatsSettings - 使用状況統計設定画面を開きます。この設定画面は、使用状況統計の許可をユーザーに求める画面です。許可が既に与えられている場合でも、常に設定画面を開きます。
queryAllPackages - デバイス上にインストールされているすべてのパッケージを取得します。QUERY_ALL_PACKAGES許可が必要です。

Example Usage

`queryAndAggregateUsageStats`

__CAPGO_KEEP_2__と__CAPGO_KEEP_3__の使用状況統計を指定された時間範囲で取得し統計します。

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`

__CAPGO_KEEP_0__の使用統計の許可が与えられているかどうかを確認します。

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/capacitor-android-usagestatsmanagerを使用している場合

@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-android-usagestatsmanagerを使用して @capgo/capacitor-android-usagestatsmanagerを接続すると、ダッシュボードの計画とcapgoの操作が可能になります。 @API/__CAPGO_KEEP_1__-android-usagestatsmanagerを使用しています。 @capgo/capacitor-android-usagestatsmanagerを使用して実装詳細については @capgo/capacitor-android-usagestatsmanager に参照してください。 Getting Started 実装詳細については Getting Started に参照してください。 API の概要実装詳細については API の概要に参照してください。イントロダクション実装詳細についてはイントロダクションに参照してください。 API のキー実装詳細については API のキーに参照してください。

使用状況管理

__CAPGO_KEEP_0__の使用状況マネージャーに関するチュートリアル