Einstieg

Installieren

Sie können unsere KI-gestützte Einrichtung verwenden, um das Plugin zu installieren. Fügen Sie den Capgo-Fähigkeiten Ihrer KI-Tool mithilfe der folgenden Befehl hinzu:

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

Verwenden Sie dann die folgende Anfrage:

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

Wenn Sie die manuelle Einrichtung bevorzugen, installieren Sie das Plugin, indem Sie die folgenden Befehle ausführen und folgen Sie den unten angegebenen Plattform-spezifischen Anweisungen:

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

Importieren

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

API Übersicht

isInKioskMode

Überprüft, ob die App derzeit im Kiosk-Modus läuft.

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

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

isSetAsLauncher

Überprüft, ob die App als Geräte-Startseite (Home-App) festgelegt ist.

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

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

enterKioskMode

Setzt den Kioskmodus, versteckt die System-UI und blockiert die Hardware-Tasten. Zudem startet ein Hintergrund-Dienst, der dafür sorgt, dass die App weniger wahrscheinlich vom System beendet wird. Die App muss als Geräte-Startbildschirm festgelegt werden, damit dies effektiv funktioniert.

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

await CapacitorAndroidKiosk.enterKioskMode();

exitKioskMode

Beendet den Kioskmodus, restauriert die normale System-UI und die Funktionalität der Hardware-Tasten. Zudem stoppt den Hintergrund-Dienst, der in kioskModusEin() gestartet wurde.

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

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

setAsLauncher

Öffnet die Einstellungen des Geräte-Startbildschirms, um dem Benutzer zu ermöglichen, diese App als Launcher festzulegen. Dies ist erforderlich, um den vollständigen Kioskmodus zu nutzen.

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

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

setAllowedKeys

Legt fest, welche Hardware-Tasten in Kioskmodus funktionieren dürfen. Standardmäßig sind alle Hardware-Tasten in Kioskmodus blockiert.

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

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

Typenreferenz

EnterKioskModeOptions

Optional Flag für 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

Konfigurationsoptionen für zulässige Hardware-Tasten in Kiosk-Modus.

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

Quelle der Wahrheit

Diese Seite wird aus dem Plugin generiert. Wenn die öffentliche __CAPGO_KEEP_0__ upstream geändert wird, sollte die Synchronisation neu gestartet werden. src/definitions.tsRe-run the sync when the public API changes upstream.

Weitermachen von Getting Started

Wenn Sie " Getting Started um ein Dashboard und API-Operationen zu planen, verbinden Sie es mit Verwenden Sie @capgo/capacitor-android-kiosk für die native Fähigkeit in Verwenden Sie @capgo/capacitor-android-kiosk, API-Übersicht für die Implementierungsdetails in API-Übersicht, Einführung für die Implementierungsdetails in Einführung, API-Schlüssel für die Implementierungsdetails in API Schlüsseln und Geräte für die Implementierungsdetails in Geräten.