Iniciación

Instalar

Puedes utilizar nuestra configuración asistida por IA para instalar el complemento. Agrega las Capgo habilidades a tu herramienta de IA utilizando el siguiente comando:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Luego utiliza el siguiente prompt:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-android-kiosk` plugin in my project.

Si prefieres la configuración Manual, instala el complemento ejecutando los siguientes comandos y sigue las instrucciones específicas de la plataforma a continuación:

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

Importar

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

API Resumen

isInKioskMode

Verifica si la aplicación está actualmente ejecutándose en modo de escritorio.

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

const { isInKioskMode } = await CapacitorAndroidKiosk.isInKioskMode();
console.log('Kiosk mode active:', isInKioskMode);

isSetAsLauncher

Verifica si la aplicación está configurada como launcher del dispositivo (aplicación de inicio).

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

const { isLauncher } = await CapacitorAndroidKiosk.isSetAsLauncher();
console.log('Is launcher:', isLauncher);

enterKioskMode

Ingresa en modo kiosco, ocultando la interfaz de usuario del sistema y bloqueando los botones de hardware. También inicia un servicio de mantenimiento en primer plano para que la aplicación sea menos probable que sea eliminada por el sistema. La aplicación debe configurarse como lanzador del dispositivo para que esto funcione de manera efectiva.

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

await CapacitorAndroidKiosk.enterKioskMode();

exitKioskMode

Sale del modo kiosco, restaurando la interfaz de usuario del sistema y la funcionalidad de los botones de hardware. También detiene el servicio de mantenimiento en primer plano iniciado en enterKioskMode().

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

await CapacitorAndroidKiosk.exitKioskMode();
console.log('Exited kiosk mode');

setAsLauncher

Abre la pantalla de ajustes del dispositivo para que el usuario pueda configurar esta aplicación como lanzador. Esto es necesario para la funcionalidad de modo kiosco completo.

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

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

setAllowedKeys

Establece qué teclas de hardware están permitidas para funcionar en modo kiosco. Por defecto, todas las teclas de hardware están bloqueadas en modo kiosco.

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

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

Referencia de tipos

EnterKioskModeOptions

Banderas opcionales para 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

Copiar a portapapeles

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

Sección titulada “Fuente de Verdad”

Re-ruta la sincronización cuando los cambios públicos __CAPGO_KEEP_0__ se actualicen en la fuente. src/definitions.ts. Re-run the sync when the public API changes upstream.

Sigue adelante desde Getting Started

Si estás utilizando Getting Started para planificar la consola de dashboard y API operaciones, conecta con Usando @capgo/capacitor-android-kiosk para la capacidad nativa en Usando @capgo/capacitor-android-kiosk, API Overview para el detalle de implementación en API Overview, Introducción para el detalle de implementación en Introducción, API Keys para los detalles de implementación en las API Claves, y Dispositivos para los detalles de implementación en Dispositivos.