Using @capgo/capacitor-android-kiosk

Capacitor Android キオスクプラグインは、キオスクモードと起動画面の機能を制御するために使用されます。このプラグインは、Android 限定です。iOS キオスクモードの場合は、デバイスのガイドドアクセス機能を使用してください。

インストール

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

このプラグインが公開するもの

isInKioskMode - アプリが現在キオスクモードで実行されているかどうかを確認します。
isSetAsLauncher - アプリがデバイスの起動画面 (ホームアプリ) として設定されているかどうかを確認します。
enterKioskMode - キオスクモードに切り替え、システム UI を非表示にしてハードウェアボタンをブロックします。さらに、前景のキープアライブサービスを開始して、アプリがシステムによって殺される可能性を低くします。アプリが起動画面として設定されている場合にのみ、効果的に機能します。
exitKioskMode - kioskモードから脱出する、通常のシステムUIとハードウェアボタンの機能を復元する。また、enterKioskMode()で始めた前景のキープアライブサービスも停止する。

使用例

`isInKioskMode`

現在、kioskモードでアプリが実行されているかどうかを確認します。

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`

kioskモードに入り、システムUIを非表示にしてハードウェアボタンをブロックする。また、前景のキープアライブサービスを開始するので、アプリがシステムによって殺される可能性が低くなる。この機能が効果的に機能するには、アプリがデバイスのホームアプリとして設定されている必要がある。

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

await CapacitorAndroidKiosk.enterKioskMode();

`exitKioskMode`

kioskモードから脱出する、通常のシステムUIとハードウェアボタンの機能を復元する。また、enterKioskMode()で始めた前景のキープアライブサービスも停止する。

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/

Android Kiosk

Android キオスク用チュートリアル