안드로이드 키오스크

capgo/capacitor-android-kiosk를 사용하여

Capacitor 안드로이드 키오스크 플러그인: 키오스크 모드 및 런처 기능을 제어하는 데 사용됩니다. 이 플러그인은 안드로이드 전용입니다. iOS 키오스크 모드는 기기의 가이드드 액세스 기능을 사용하여야 합니다.

설치

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

이 플러그인이 제공하는 것

• isInKioskMode - 현재 앱이 키오스크 모드에서 실행되고 있는지 확인합니다.
• isSetAsLauncher - 앱이 기기의 런처 앱으로 설정되어 있는지 확인합니다.
• enterKioskMode - 키오스크 모드를 시작하여 시스템 UI를 숨기고 하드웨어 버튼을 차단합니다. 또한 foreground keep-alive 서비스를 시작하여 앱이 시스템에 의해 죽히지 않도록 합니다. 이 기능이 효과적으로 작동하려면 앱이 기기의 런처 앱으로 설정되어 있어야 합니다.
• 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 및 하드웨어 버튼 기능을 복원하고, 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/