使用状況統計マネージャー __CAPGO_KEEP_0__ リポジトリ

インストール

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

インポート

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

API オーバービュー

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

「型の参照」セクション

UsageStatsOptions

使用状況統計のクエリオプション

export interface UsageStatsOptions {
  /**
   * The inclusive beginning of the range of stats to include in the results.
   * Defined in terms of "Unix time"
   */
  beginTime: number;

  /**
   * The exclusive end of the range of stats to include in the results.
   * Defined in terms of "Unix time"
   */
  endTime: number;
}

UsageStats

Androidアプリの使用状況統計

export interface UsageStats {
  /**
   * The first timestamp of the usage stats.
   */
  firstTimeStamp: number;
  /**
   * The last timestamp of the usage stats.
   */
  lastTimeStamp: number;
  /**
   * Only available on Android Q (API level 29) and above.
   * Will be undefined on lower Android versions.
   */
  lastTimeForegroundServiceUsed?: number;
  /**
   * The last time the app was used.
   */
  lastTimeUsed: number;
  /**
   * Only available on Android Q (API level 29) and above.
   * Will be undefined on lower Android versions.
   */
  lastTimeVisible?: number;
  /**
   * The name of the package.
   */
  packageName: string;
  /**
   * Only available on Android Q (API level 29) and above.
   * Will be undefined on lower Android versions.
   */
  totalForegroundServiceUsed?: number;
  /**
   * The total time the app was in the foreground.
   */
  totalTimeInForeground: number;
  /**
   * Only available on Android Q (API level 29) and above.
   * Will be undefined on lower Android versions.
   */
  totalTimeVisible?: number;
}

UsageStatsPermissionResult

使用状況統計の許可チェック結果

export interface UsageStatsPermissionResult {
  /**
   * Whether the usage stats permission is granted.
   */
  granted: boolean;
}

PackageInfo

インストール済みパッケージの基本情報

export interface PackageInfo {
  /** Package name */
  packageName: string;
  /** App display name */
  appName: string;
  /** Version name string */
  versionName: string;
  /** Version code number */
  versionCode: number;
  /** First install time in milliseconds since epoch */
  firstInstallTime: number;
  /** Last update time in milliseconds since epoch */
  lastUpdateTime: number;
}

真実の源

このページはプラグインの src/definitions.ts再同期を実行してください。 API の変更を検知したときに。

始めてから続けてください：始め方

Capacitor を使用している場合 始めてから続けてください：始め方 ダッシュボードと API の作業を計画するには、Capacitor を接続してください。 Capacitor を使用して Android の使用状況管理を実装するには、@capgo/capacitor-android-usagestatsmanager を使用します。 Capacitor を使用して Android の使用状況管理を実装するには、@capgo/capacitor-android-usagestatsmanager を使用します。 API の概要 API の実装詳細については、 Introduction __CAPGO_KEEP_0__ の実装詳細については、 API キー API の実装詳細については、API キー、そして Devices __CAPGO_KEEP_0__ の実装詳細については、Devices.