Skip to main content
플러그인으로 돌아가기
@capgo/capacitor-android-kiosk
튜토리얼
@capgo/capacitor-android-kiosk

안드로이드 키오스크

안드로이드 기기를 키오스크 모드에 잠그고 런처 기능 및 하드웨어 키 제어를 제공합니다.

Guide

안드로이드 키오스크 튜토리얼

Using @capgo/capacitor-android-kiosk

Capacitor Android Kiosk Plugin for controlling kiosk mode and launcher functionality. This plugin is Android-only. For iOS kiosk mode, use the device's Guided Access feature.

설치

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

전체 참조

Using @capgo/capacitor-android-kiosk

이 기능을 사용 중이라면 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 Capgo API Keys.