개요
“개요” 섹션@capgo/capacitor-android-kiosk 키오스크 모드, 런처 고정, 하드웨어 키 정책으로 여러 대의 태블릿을 하나의 Capacitor 경험에 고정합니다.
플랫폼 지원
“플랫폼 지원” 섹션| 플랫폼 | 지원 | 참고 사항 |
|---|---|---|
| iOS | 아니요 | Android 중심 |
| Android | 지원 | README에 따른 Device owner 프로비저닝 |
| 웹 | 아니요 | 해당 없음 |
핵심 기능
“핵심 기능” 섹션isInKioskMode- 앱이 현재 키오스크 모드로 실행 중인지 확인합니다.isSetAsLauncher- 앱이 디바이스 런처(홈 앱)로 설정되어 있는지 확인합니다.enterKioskMode- 키오스크 모드로 진입해 시스템 UI를 숨기고 하드웨어 버튼을 차단합니다. 또한 앱이 시스템에 의해 종료될 가능성을 줄이도록 포그라운드 keep-alive 서비스를 시작합니다. 이 기능이 제대로 작동하려면 앱이 디바이스 런처로 설정되어 있어야 합니다.exitKioskMode- 키오스크 모드에서 벗어나 정상적인 시스템 UI와 하드웨어 버튼 기능을 복원합니다. 또한 enterKioskMode()에서 시작된 포그라운드 keep-alive 서비스를 중지합니다.
공개 API
“Public API” 섹션| 메서드 | 설명 |
|---|---|
isInKioskMode | 앱이 현재 키오스크 모드로 실행 중인지 확인합니다. |
isSetAsLauncher | 앱이 기기 런처(홈 앱)로 설정되어 있는지 확인합니다. |
enterKioskMode | 키오스크 모드로 진입하여 시스템 UI를 숨기고 하드웨어 버튼을 차단합니다. 또한 포그라운드 keep-alive 서비스를 시작하여 시스템에 의해 앱이 종료될 가능성을 낮춥니다. 이 기능이 효과적으로 작동하려면 앱이 기기 런처로 설정되어 있어야 합니다. |
exitKioskMode | 키오스크 모드를 종료하고 일반 시스템 UI와 하드웨어 버튼 기능을 복구합니다. 또한 enterKioskMode()에서 시작된 포그라운드 keep-alive 서비스를 중지합니다. |
setAsLauncher | 사용자가 이 앱을 런처로 설정할 수 있도록 기기의 홈 화면 설정 페이지를 엽니다. 전체 키오스크 모드 기능을 사용하려면 이 설정이 필요합니다. |
setAllowedKeys | 키오스크 모드에서 작동을 허용할 하드웨어 키를 설정합니다. 기본적으로 키오스크 모드에서는 모든 하드웨어 키가 차단됩니다. |
getPluginVersion | 네이티브 Capacitor 플러그인 버전을 가져옵니다. |
Source of Truth
“Source Of Truth” 섹션이 레퍼런스는 다음에서 동기화됩니다. src/definitions.ts 에서 capacitor-android-kiosk.
@capgo/capacitor-android-kiosk에서 계속하기
“@capgo/capacitor-android-kiosk에서 계속하기” 섹션사용 중이라면 @capgo/capacitor-android-kiosk 대시보드 및 API 운영을 계획하려면, 이를 다음과 연결하세요 @capgo/capacitor-android-kiosk 사용하기 @capgo/capacitor-android-kiosk 사용 시 네이티브 기능을 위해, API 개요 구현 세부 사항은 API 개요에서 소개 구현 세부 사항은 소개에서 API 키 API Keys의 구현 세부 사항은, 기기 Devices의 구현 세부 사항은.
