メインコンテンツへスキップ
@capgo/capacitor-android-usagestatsmanager アナリティクス オープンソース

利用統計マネージャー Capacitor プラグイン

Androidの利用統計にアクセスし、アプリの使用時間やスクリーンタイムを分析

インストール

bun add @capgo/capacitor-android-usagestatsmanager bunx cap sync
npm、pnpm、または yarn
  • npm install @capgo/capacitor-android-usagestatsmanager
  • pnpm add @capgo/capacitor-android-usagestatsmanager
  • yarn add @capgo/capacitor-android-usagestatsmanager

ガイド

Capacitor で Usage Stats Manager を使う方法

@capgo/capacitor-android-usagestatsmanager の使い方

Android の UsageStatsManager API にアクセスするための Capacitor プラグイン。

インストール

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 CapacitorUsageStatsManager.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 CapacitorUsageStatsManager.isUsageStatsPermissionGranted();
if (!granted) {
  await CapacitorUsageStatsManager.openUsageStatsSettings();
}

openUsageStatsSettings

使用統計の設定画面を開きます。この画面ではユーザーが使用統計の権限を許可できます。権限がすでに許可されていても、常に設定画面が開きます。

import { CapacitorUsageStatsManager } from '@capgo/capacitor-android-usagestatsmanager';

await CapacitorUsageStatsManager.openUsageStatsSettings();

queryAllPackages

デバイスにインストールされているすべてのパッケージをクエリします。QUERY_ALL_PACKAGES 権限が必要です。

import { CapacitorUsageStatsManager } from '@capgo/capacitor-android-usagestatsmanager';

const { packages } = await CapacitorUsageStatsManager.queryAllPackages();
packages.forEach(pkg => {
  console.log(`${pkg.appName} (${pkg.packageName}): v${pkg.versionName}`);
});

リファレンス全文

Using @capgo/capacitor-android-usagestatsmanager から続きを読む

使用している場合 @capgo/capacitor-android-usagestatsmanager の使い方 ダッシュボードと API の運用を計画するには、これを次と連携させます @capgo/capacitor-android-usagestatsmanager @capgo/capacitor-android-usagestatsmanager の実装詳細については、 スタートガイド スタートガイドの実装詳細については、 API の概要 「API の概要」の実装の詳細については、 はじめに はじめにの実装詳細、および API キー API Keys の実装詳細については、

よくある質問

Usage Stats Manager プラグインの FAQ

Capacitor アプリに Usage Stats Manager プラグインをインストールするには?

"bun add @capgo/capacitor-android-usagestatsmanager" (または "npm install @capgo/capacitor-android-usagestatsmanager") を実行し、次に "bunx cap sync" を実行して、iOS と Android プロジェクトがネイティブ code を認識するようにします。アプリの code から "@capgo/capacitor-android-usagestatsmanager" をインポートします。

@capgo/capacitor-android-usagestatsmanager は React、Vue、Angular で動作しますか?

はい。Usage Stats Manager は Capacitor パッケージなので、Ionic、React、Vue、Angular、Svelte、プレーン JavaScript を含む、Capacitor 内で動作するすべての Web フレームワークで動作します。

@capgo/capacitor-android-usagestatsmanager はどの Capacitor バージョンをサポートしていますか?

Capgo プラグインは Capacitor のメジャーバージョンに合わせています。使用している Capacitor のメジャーバージョンに一致するプラグインのメジャーバージョンを使ってください (例: Capacitor 8 ならプラグイン v8)。GitHub の README にある互換性テーブルに、メンテナンス中のバージョンが記載されています。

@capgo/capacitor-android-usagestatsmanager は無料かつオープンソースですか?

はい。ソース code は https://github.com/Cap-go/capacitor-android-usagestatsmanager/ の GitHub で公開されており、npm から無料でインストールできます。バグレポートやプルリクエストをお待ちしています。

Usage Stats Manager を使用している code を、App Store のレビューなしで更新できますか?

プラグインのインストールやアップグレードはネイティブの code を変更するため、新しいストアビルドが必要です。その後は、プラグインを呼び出す JavaScript、HTML、CSS の変更を Capgo Live Updates で即座に配信できます。

アプリの審査を待たずに Usage Stats Manager の変更をリリース

プラグインをストア用ビルドに組み込めば、Capgo live updates で JavaScript、HTML、CSS の変更を数分でユーザーに配信できます

Capgo から始める