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

Android Kiosk

Android デバイスをキオスクモードにロックし、起動画面とハードウェアキーの制御を実現

ガイド

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');

フルリファレンス

「@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 に参照してください。