가이드
안드로이드 키오스크에 대한 튜토리얼
@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()에서 시작한 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/
capgo을 계속 사용하세요. @capgo/capacitor-android-kiosk
__CAPGO_KEEP_2__ __CAPGO_KEEP_0__를 사용하고 있다면 capgo @capgo/capacitor-android-kiosk 를 사용하여 대시보드와 API 운영을 계획하고 싶다면 API @API/__CAPGO_KEEP_1__-android-kiosk @capgo/capacitor-android-kiosk capgo @capgo/capacitor-android-kiosk 의 구현 세부 사항을 확인하려면 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-android-kiosk 을 참조하세요. 시작하기: API의 구현 세부 사항을 확인하려면 시작하기를 참조하세요. API 개요 implementation 세부 정보를 위한 API 개요에 대해 소개 implementation 세부 정보를 위한 Introduction에 대해 API 키 implementation 세부 정보를 위한 API 키에 대해