Getting Started

설치

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

수입

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

키오스크 모드에 들어가기

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

await CapacitorAndroidKiosk.enterKioskMode();

exitKioskMode

키오스크 모드에서 나와서 시스템 UI와 하드웨어 버튼의 기능을 복원합니다. 키오스크 모드에 들어가기()에서 시작한 foreground keep-alive 서비스도 중지합니다.

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

타입 참조

EnterKioskModeOptions

선택적 플래그 enterKioskMode.

export interface EnterKioskModeOptions {
  /**
   * After reboot, start the app so you can call `enterKioskMode()` again. Best-effort only (OEM
   * behavior, force-stop). Omit to keep the saved value. Cleared when you call `exitKioskMode()`.
   */
  restoreAfterReboot?: boolean;

  /**
   * Periodically tries to bring the app to the foreground. Skipped while the screen is off. Often
   * blocked from the background on some devices—being the default launcher, relaxing battery limits,
   * and allowing exact alarms (where required) improve odds. Omit to keep the saved value.
   */
  relaunch?: boolean;

  /** Minutes between relaunch attempts when `relaunch` is on. Range 5–60; default 15. */
  relaunchIntervalMinutes?: number;
}

AllowedKeysOptions

키오스크 모드에서 허용된 하드웨어 키의 구성 옵션입니다.

export interface AllowedKeysOptions {
  /**
   * Allow volume up button
   * @default false
   */
  volumeUp?: boolean;

  /**
   * Allow volume down button
   * @default false
   */
  volumeDown?: boolean;

  /**
   * Allow back button
   * @default false
   */
  back?: boolean;

  /**
   * Allow home button
   * @default false
   */
  home?: boolean;

  /**
   * Allow recent apps button
   * @default false
   */
  recent?: boolean;

  /**
   * Allow power button
   * @default false
   */
  power?: boolean;

  /**
   * Allow camera button (if present)
   * @default false
   */
  camera?: boolean;

  /**
   * Allow menu button (if present)
   * @default false
   */
  menu?: boolean;
}

실제 원천

이 페이지는 플러그인의 src/definitions.ts. upstream에서 pubic API이 변경될 때 다시 싱크를 실행하세요.

시작부터 계속하기

Capgo를 사용 중이라면 시작하기 API 대시보드와 연산을 계획하고 싶다면, API와 연결하세요. Using @capgo/capacitor-android-kiosk for the native capability in Using @capgo/capacitor-android-kiosk, API 개요 API 구현 방법 소개 __CAPGO_KEEP_0__ 키 API API 키의 구현 세부 사항에 대해 장치 __CAPGO_KEEP_0__ 키의 구현 세부 사항에 대해.