안드로이드 키오스크 Capacitor 플러그인

@capgo/capacitor-android-kiosk 사용

Capacitor 안드로이드 키오스크 플러그인은 키오스크 모드와 런처 기능을 제어하는 플러그인입니다. 이 플러그인은 안드로이드 전용입니다. iOS 키오스크 모드는 장치의 가이드드 액세스 기능을 사용하세요.

설치

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

bunx cap sync code을 로컬 프로젝트에 복사합니다. 플러그인 업그레이드 후 다시 실행하세요.

Import

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

API을 한눈에

예시

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

setAsLauncher()

기기의 홈 화면 설정을 열어 사용자가 이 앱을 런처로 설정할 수 있도록 합니다. 이 기능이 완전히 작동하려면 이 앱을 런처로 설정해야 합니다.

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

await CapacitorAndroidKiosk.setAsLauncher();
// User will be prompted to select this app as the home app

setAllowedKeys()

키오스크 모드에서 작동할 수 있는 하드웨어 키를 설정합니다. 기본적으로 키오스크 모드에서는 모든 하드웨어 키가 차단됩니다.

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

// Allow volume keys only
await CapacitorAndroidKiosk.setAllowedKeys({
  volumeUp: true,
  volumeDown: true,
  back: false,
  home: false,
  recent: false
});

전체 참조

• GitHub 저장소
• 문서
• API 참조

Using @capgo/capacitor-android-kiosk에서 계속하세요

키오스크 모드에서 작동하는 앱을 사용하는 경우 @Capacitor-capgo/capacitor-android-kiosk 대시보드와 @API/__CAPGO_KEEP_1__-android-kiosk를 연결하여 Capacitor-Android-Kiosk를 사용하여 @capgo/capacitor-android-kiosk for the implementation detail in @capgo/capacitor-android-kiosk, Getting Started Getting Started의 구현 세부 정보 API 개요 API Overview의 구현 세부 정보 Introduction Introduction의 구현 세부 정보, 그리고 API 키 API Keys의 구현 세부 정보