ガイド
Androidキオスクチュートリアル
Using @capgo/capacitor-android-kiosk
Capacitor Androidキオスクプラグインは、キオスクモードとランチャー機能を制御するために使用されます。このプラグインはAndroid専用です。iOSキオスクモードの場合は、デバイスのガイドドアクセス機能を使用してください。
インストール
bun add @capgo/capacitor-android-kiosk
bunx cap sync
このプラグインが公開するもの
isInKioskMode- アプリが現在キオスクモードで実行されているかどうかを確認します。isSetAsLauncher- アプリがデバイスのランチャー (ホームアプリ) として設定されているかどうかを確認します。enterKioskMode- キオスクモードに切り替え、システムUIを非表示にしてハードウェアボタンの機能をブロックします。さらに、フォアグラウンドキープアライブサービスを開始して、アプリがシステムによって殺される可能性を低くします。アプリがデバイスのランチャーとして設定されている場合にのみ、この機能が効果的に機能します。exitKioskMode- キオスクモードを終了して、通常のシステムUIとハードウェアボタンの機能を復元します。さらに、enterKioskMode() で開始したフォアグラウンドキープアライブサービスを停止します。
例の使用
isInKioskMode
アプリが現在キオスクモードで実行されているかどうかを確認します。
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
キオスクモードに切り替え、システムUIとハードウェアボタンの非表示を実行します。また、フォアグラウンドキープアライブサービスを開始して、アプリがシステムによって殺される可能性を低くします。この機能が効果的に動作するには、アプリがデバイスのホームアプリとして設定されている必要があります。
import { CapacitorAndroidKiosk } from '@capgo/capacitor-android-kiosk';
await CapacitorAndroidKiosk.enterKioskMode();
exitKioskMode
キオスクモードを終了し、通常のシステムUIとハードウェアボタンの機能を復元します。また、フォアグラウンドキープアライブサービスを停止します。
import { CapacitorAndroidKiosk } from '@capgo/capacitor-android-kiosk';
await CapacitorAndroidKiosk.exitKioskMode();
console.log('Exited kiosk mode');
フルリファレンス
- GitHub: https://github.com/Cap-go/capacitor-android-kiosk/
- ドキュメント: /docs/plugins/android-kiosk/
「@capgo/capacitor-android-kiosk」を使用して、続行してください。
「@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-android-kiosk」を使用している場合 @capgo/capacitor-android-kiosk」を使用して、ダッシュボードとcapgoのオペレーションを計画する場合、@capgo/capacitor-android-kioskと接続してください。 @API/__CAPGO_KEEP_1__-android-kiosk @capgo/capacitor-android-kiosk 実装詳細については @capgo/capacitor-android-kiosk に参照してください。 Getting Started 実装詳細については Getting Started に参照してください。 API Overview 実装詳細については API Overview に参照してください。 Introduction 実装詳細については Introduction に参照してください。 API Keys 実装詳細については API Keys に参照してください。