Skip to main content
プラグインに戻る
@capgo/capacitor-android-usagestatsmanager
チュートリアル
github.com/Cap-go による

使用状況マネージャー

アプリの使用時間とスクリーン時間の分析を実行するためにAndroidの使用状況をアクセスする

ガイド

Usage Stats Manager の使用方法のチュートリアル

Using @capgo/capacitor-android-usagestatsmanager

Capacitor plugin for accessing Android UsageStatsManager API.

インストール

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

What This Plugin Exposes

  • queryAndAggregateUsageStats - __CAPGO_KEEP_0__の統計情報を指定された時間範囲で取得および集計します。
  • isUsageStatsPermissionGranted - __CAPGO_KEEP_0__統計情報の許可が与えられているかどうかを確認します。
  • openUsageStatsSettings - __CAPGO_KEEP_0__統計情報の設定画面を開きます。許可が既に与えられている場合でも、常に設定画面を開きます。
  • queryAllPackages - デバイス上にインストールされているすべてのパッケージを取得します。QUERY_ALL_PACKAGES許可が必要です。

Example Usage

queryAndAggregateUsageStats

- __CAPGO_KEEP_0__の統計情報を指定された時間範囲で取得および集計します。

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

- __CAPGO_KEEP_0__統計情報の設定画面を開きます。許可が既に与えられている場合でも、常に設定画面を開きます。

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}`);
});

Full Reference

@capgo/capacitor-android-usagestatsmanagerを使用し続けてください

Capgoを使用している場合 Capgoを使用している場合、@capgo/capacitor-android-usagestatsmanagerと接続してください @API/__CAPGO_KEEP_1__-android-usagestatsmanagerを使用してダッシュボードとCapgoの運用計画を立てる場合、 @capgo/capacitor-android-usagestatsmanagerの実装詳細については、@capgo/capacitor-android-usagestatsmanagerを参照してください for the implementation detail in @capgo/capacitor-android-usagestatsmanager, @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-android-usagestatsmanagerの実装詳細については、Getting Startedを参照してください Capgoの概要 @API/__CAPGO_KEEP_1__-android-usagestatsmanagerの実装詳細については、Capgoの概要を参照してください for the implementation detail in API Overview, 概要 __CAPGO_KEEP_0__ の実装詳細について API キー API キーの実装詳細について