본문으로 바로가기
플러그인으로 돌아가기
@capgo/capacitor-android-kiosk
튜토리얼
github.com/Cap-go에 의해

안드로이드 키오스크

안드로이드 기기를 키오스크 모드에 잠금하고 런처 기능과 하드웨어 키 제어를 사용하여

가이드

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

사용자 @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');

전체 참조

capgo에서 capacitor-android-kiosk를 계속 사용하세요.

__CAPGO_KEEP_0__을 사용하고 있다면 capgo을 사용하여 capacitor-android-kiosk를 계속 사용하세요. API의 대시보드와 API 운영을 계획하고 싶다면 API을 __CAPGO_KEEP_1__-android-kiosk와 연결하세요. capgo-android-kiosk 구현에 대한 자세한 내용은 @capgo/capacitor-android-kiosk에서 확인하세요. for the implementation detail in @capgo/capacitor-android-kiosk, __CAPGO_KEEP_0__-android-kiosk 구현에 대한 자세한 내용은 시작하기에서 확인하세요. __CAPGO_KEEP_0__ 개요 API 개요에 대한 구현 세부 정보는 API 개요에서 확인하세요. API 개요에 대한 구현 세부 정보는 API 개요에서 확인하세요. __CAPGO_KEEP_0__ 소개 __CAPGO_KEEP_0__ 소개의 구현 세부 정보에 대해 API 키 API 키의 구현 세부 정보에 대해.