Erste Schritte

Kopiere einen Setup-Prompt mit den Installationsschritten und dem vollständigen Markdown-Guide für dieses Plugin.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-flash`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/flash/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

Installieren

Du kannst unser KI-gestütztes Setup nutzen, um das Plugin zu installieren. Füge die Capgo Skills mit dem folgenden Befehl deinem KI-Tool hinzu:

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

Nutze dann diesen Prompt:

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

Wenn du ein manuelles Setup bevorzugst, installiere das Plugin mit den folgenden Befehlen und befolge die plattformspezifischen Anweisungen unten:

bun add @capgo/capacitor-flash
bunx cap sync

Importieren

import { CapacitorFlash } from '@capgo/capacitor-flash';

Quickstart

import { CapacitorFlash } from '@capgo/capacitor-flash';

const { value: available } = await CapacitorFlash.isAvailable();
if (!available) {
  toast('No flashlight on this device');
  return;
}
await CapacitorFlash.switchOn({ intensity: 0.5 });

Beispiel: QR-Scanner-Begleit-App

await CapacitorFlash.switchOn({ intensity: 1 });
const code = await scanFrame();
await CapacitorFlash.switchOff();

Häufige Stolperfallen

In finally ausschalten: Dauerhaft eingeschaltete Taschenlampe verbraucht Akku und blockiert andere Kamera-Apps.
Web-Berechtigungen: Mobile Browser benötigen eine Kameraberechtigung, bevor sie auf die Taschenlampe zugreifen.
Intensitätsunterstützung: Werte über dem Hardware-Maximum werden begrenzt; prüfen Sie dies mit isSwitchedOn().

API Übersicht

`isAvailable`

Prüft, ob die Taschenlampe auf dem Gerät verfügbar ist.

import { CapacitorFlash } from '@capgo/capacitor-flash';

const { value } = await CapacitorFlash.isAvailable();
if (value) {
  console.log('Flashlight is available');
}

`switchOn`

Schaltet die Taschenlampe ein.

import { CapacitorFlash } from '@capgo/capacitor-flash';

// Turn on at full brightness
await CapacitorFlash.switchOn({ intensity: 1.0 });

// Turn on at half brightness
await CapacitorFlash.switchOn({ intensity: 0.5 });

`switchOff`

Schaltet die Taschenlampe aus.

import { CapacitorFlash } from '@capgo/capacitor-flash';

await CapacitorFlash.switchOff();

`isSwitchedOn`

Prüft, ob die Taschenlampe gerade eingeschaltet oder ausgeschaltet ist.

import { CapacitorFlash } from '@capgo/capacitor-flash';

const { value } = await CapacitorFlash.isSwitchedOn();
console.log('Flashlight is on:', value);

`toggle`

Schalte die Taschenlampe ein oder aus.

import { CapacitorFlash } from '@capgo/capacitor-flash';

const { value } = await CapacitorFlash.toggle();
console.log('Flashlight toggled, now on:', value);

Source of Truth

Diese Seite wird aus dem Plugin generiert src/definitions.ts. Führe den Sync erneut aus, wenn sich das öffentliche API upstream ändert.

Weiter geht's nach Getting Started

Wenn du es nutzt Erste Schritte um Dashboard- und API-Operationen zu planen, verbinde es mit @capgo/capacitor-flash verwenden für die native Funktion bei der Nutzung von @capgo/capacitor-flash, API Übersicht für Details zur Implementierung im API Overview, Einführung für die Implementierungsdetails in der Einleitung, API Schlüssel für das Implementierungsdetail in API Keys und Geräte für das Implementierungsdetail in Devices.