안드로이드 키오스크 플러그인 (@capgo/capacitor-android-kiosk) 사용

Capacitor 안드로이드 키오스크 플러그인: 키오스크 모드 및 런처 기능 제어

설치

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

이 플러그인이 제공하는 것

isInKioskMode - 현재 앱이 키오스크 모드에서 실행 중인지 확인합니다.
isSetAsLauncher - 앱이 장치 런처(홈 앱)로 설정되어 있는지 확인합니다.
enterKioskMode - 시스템 UI를 숨기고 하드웨어 버튼을 차단하는 키오스크 모드에 들어갑니다. 또한 시스템에 의해 앱이 죽지 않도록 foreground keep-alive 서비스를 시작합니다. 이 기능이 효과적으로 작동하려면 앱을 기기 런처로 설정해야 합니다.
exitKioskMode - 키오스크 모드에서 나옵니다. 시스템 UI와 하드웨어 버튼의 기능이 원래대로 돌아옵니다. 또한 enterKioskMode()에서 시작한 foreground keep-alive 서비스를 중지합니다.

예시 사용

`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를 숨기고 하드웨어 버튼을 차단하는 키오스크 모드에 들어갑니다. 또한 시스템에 의해 앱이 죽지 않도록 foreground keep-alive 서비스를 시작합니다. 이 기능이 효과적으로 작동하려면 앱을 기기 런처로 설정해야 합니다.

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

await CapacitorAndroidKiosk.enterKioskMode();

`exitKioskMode`

키오스크 모드에서 나옵니다. 시스템 UI와 하드웨어 버튼의 기능이 원래대로 돌아옵니다. 또한 enterKioskMode()에서 시작한 foreground keep-alive 서비스를 중지합니다.

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/

Keep going from Using @capgo/capacitor-android-kiosk

만약에 __CAPGO_KEEP_0__을 사용하고 있다면 Capacitor @capgo/capacitor-android-kiosk API과 API 연동을 위해 @API/__CAPGO_KEEP_1__-android-kiosk Capacitor @capgo/capacitor-android-kiosk Capacitor @capgo/capacitor-android-kiosk Getting Started Getting Started API Overview API Overview Introduction Introduction API Keys implementation 세부 정보에 대한 API 키.

안드로이드 키오스크