メインコンテンツにジャンプ
プラグインに戻る
@capgo/capacitor-android-kiosk
チュートリアル
@capgo/capacitor-android-kiosk

Android Kiosk

Android デバイスをキオスクモードにロックし、ランチャー機能とハードウェアキーの制御を実現します。

ガイド

Android Kioskのチュートリアル

capgo/capacitor-android-kioskの使用

Capacitor Android Kioskプラグイン

インストール

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

このプラグインが提供するもの

  • isInKioskMode - アプリが現在キオスクモードで実行されているかどうかを確認します。
  • isSetAsLauncher - アプリがデバイスのホームアプリとして設定されているかどうかを確認します。
  • enterKioskMode - Androidキオスクモードに移行し、システムUIとハードウェアボタンのブロックを実行します。 foreground keep-aliveサービスも開始するため、アプリがシステムによって殺される可能性が低くなります。 この機能が有効になるためには、アプリをデバイスのホームアプリとして設定する必要があります。
  • exitKioskMode - Androidキオスクモードを終了し、通常のシステムUIとハードウェアボタンの機能を復元します。 foreground keep-aliveサービスも開始したenterKioskMode()を停止します。

例の使用

isInKioskMode

現在、Androidキオスクモードで実行されているかどうかを確認します。

import { CapacitorAndroidKiosk } from '@capgo/capacitor-android-kiosk';

const { isInKioskMode } = await CapacitorAndroidKiosk.isInKioskMode();
console.log('Kiosk mode active:', isInKioskMode);

isSetAsLauncher

デバイスのホームアプリとして設定されているかどうかを確認します。

import { CapacitorAndroidKiosk } from '@capgo/capacitor-android-kiosk';

const { isLauncher } = await CapacitorAndroidKiosk.isSetAsLauncher();
console.log('Is launcher:', isLauncher);

enterKioskMode

Androidキオスクモードに移行し、システムUIとハードウェアボタンのブロックを実行します。 foreground keep-aliveサービスも開始するため、アプリがシステムによって殺される可能性が低くなります。 この機能が有効になるためには、アプリをデバイスのホームアプリとして設定する必要があります。

import { CapacitorAndroidKiosk } from '@capgo/capacitor-android-kiosk';

await CapacitorAndroidKiosk.enterKioskMode();

exitKioskMode

Androidキオスクモードを終了し、通常のシステムUIとハードウェアボタンの機能を復元します。 foreground keep-aliveサービスも開始したenterKioskMode()を停止します。

import { CapacitorAndroidKiosk } from '@capgo/capacitor-android-kiosk';

await CapacitorAndroidKiosk.exitKioskMode();
console.log('Exited kiosk mode');

フルリファレンス

Using @capgo/capacitor-android-kiosk

Capacitor Android Kiosk を使用している場合 Using @capgo/capacitor-android-kiosk to plan dashboard and API operations, connect it with @capgo/capacitor-android-kiosk for the implementation detail in @capgo/capacitor-android-kiosk, Capacitor Android Kiosk の実装詳細については、Getting Started を参照してください Capacitor Android Kiosk の概要 API Overview for the implementation detail in API Overview, Capacitor Android Kiosk の実装詳細については、Introduction を参照してください Capacitor Android Kiosk のキー API Keys APIの実装詳細についてはAPIキーショートに。