Switch the Flashlight / Torch of your device.
npm install @capgo/capacitor-flash
npx cap sync
Works out of the box
AndroidManifest.xml
file<!-- Permissions: Allows access to flashlight -->
<uses-permission android:name="android.permission.CAMERA" android:maxSdkVersion="23" />
<uses-permission android:name="android.permission.FLASHLIGHT" />
<!-- Actual Hardware Features Used-->
<uses-feature android:name="android.hardware.camera.flash" android:required="true" />
isAvailable() => any
Checks if flashlight is available
Returns: any
switchOn(options: { intensity?: number; }) => any
Turns the flashlight on
Param | Type |
---|---|
options |
{ intensity?: number; } |
Returns: any
switchOff() => any
Turns the flashlight off
Returns: any
isSwitchedOn() => any
Checks if the flashlight is turned on or off
Returns: any
toggle() => any
Toggle the flashlight
Returns: any
Sing @capgo/capacitor-flash Paket
Das @capgo/capacitor-flash
Paket ermöglicht es Ihnen, das Taschenlampe/Licht Ihres Geräts ein- und auszuschalten. In diesem Tutorial werden wir Sie durch den Prozess der Installation und Verwendung dieses Pakets in Ihrer Ionic Capacitor-App führen.
Um das @capgo/capacitor-flash
Paket zu installieren, führen Sie den folgenden Befehl im Wurzelverzeichnis Ihres Projekts aus:
npm install @capgo/capacitor-flash
npx cap sync
Das @capgo/capacitor-flash
Paket funktioniert sofort auf iOS, sodass keine zusätzliche Einrichtung erforderlich ist.
Für Android müssen Sie die erforderlichen Berechtigungen in der Datei AndroidManifest.xml
Ihrer App deklarieren. Fügen Sie die folgenden Zeilen innerhalb des <manifest>
Tags hinzu:
<uses-permission android:name="android.permission.CAMERA" />
<uses-feature android:name="android.hardware.camera" />
Das @capgo/capacitor-flash
Paket bietet die folgenden API-Methoden:
Diese Methode prüft, ob die Taschenlampe auf dem Gerät verfügbar ist.
import { CapacitorFlash } from '@capgo/capacitor-flash';
async function checkFlashlightAvailability() {
const isAvailable = await CapacitorFlash.isAvailable();
console.log('Flashlight availability:', isAvailable);
}
Diese Methode schaltet die Taschenlampe des Geräts ein. Sie können Optionen übergeben, um die Intensität der Taschenlampe anzupassen.
import { CapacitorFlash } from '@capgo/capacitor-flash';
async function switchOnFlashlight() {
const options = {
intensity: 100, // Set the intensity to 100%
};
await CapacitorFlash.switchOn(options);
console.log('Flashlight switched on');
}
Diese Methode schaltet die Taschenlampe des Geräts aus.
import { CapacitorFlash } from '@capgo/capacitor-flash';
async function switchOffFlashlight() {
await CapacitorFlash.switchOff();
console.log('Flashlight switched off');
}
Diese Methode überprüft, ob die Taschenlampe derzeit ein- oder ausgeschaltet ist.
import { CapacitorFlash } from '@capgo/capacitor-flash';
async function checkFlashlightStatus() {
const isSwitchedOn = await CapacitorFlash.isSwitchedOn();
console.log('Flashlight status:', isSwitchedOn ? 'ON' : 'OFF');
}
Diese Methode schaltet die Taschenlampe um, d.h. wenn sie eingeschaltet ist, wird sie ausgeschaltet, und umgekehrt.
import { CapacitorFlash } from '@capgo/capacitor-flash';
async function toggleFlashlight() {
await CapacitorFlash.toggle();
console.log('Flashlight toggled');
}
Das ist alles! Sie haben erfolgreich gelernt, wie Sie das @capgo/capacitor-flash
Paket in Ihrer Ionic Capacitor-App verwenden, um die Taschenlampe/Licht Ihres Geräts zu steuern.