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
Chantez le package @capgo/capacitor-flash
Le package @capgo/capacitor-flash
vous permet d'allumer et d'éteindre la lampe de poche de votre appareil. Dans ce tutoriel, nous vous guiderons à travers le processus d'installation et d'utilisation de ce package dans votre application Ionic Capacitor.
Pour installer le package @capgo/capacitor-flash
, exécutez la commande suivante dans le répertoire racine de votre projet :
npm install @capgo/capacitor-flash
npx cap sync
Le package @capgo/capacitor-flash
fonctionne immédiatement sur iOS, donc aucune configuration supplémentaire n'est requise.
Pour Android, vous devez déclarer les autorisations nécessaires dans le fichier AndroidManifest.xml
de votre application. Ajoutez les lignes suivantes à l'intérieur de la balise <manifest>
:
<uses-permission android:name="android.permission.CAMERA" />
<uses-feature android:name="android.hardware.camera" />
Le package @capgo/capacitor-flash
fournit les méthodes API suivantes :
Cette méthode vérifie si la lampe de poche est disponible sur l'appareil.
import { CapacitorFlash } from '@capgo/capacitor-flash';
async function checkFlashlightAvailability() {
const isAvailable = await CapacitorFlash.isAvailable();
console.log('Flashlight availability:', isAvailable);
}
Cette méthode allume la lampe de poche de l'appareil. Vous pouvez passer des options pour ajuster l'intensité de la lampe de poche.
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');
}
Cette méthode éteint la lampe de poche de l'appareil.
import { CapacitorFlash } from '@capgo/capacitor-flash';
async function switchOffFlashlight() {
await CapacitorFlash.switchOff();
console.log('Flashlight switched off');
}
Cette méthode vérifie si la lampe de poche est actuellement allumée ou éteinte.
import { CapacitorFlash } from '@capgo/capacitor-flash';
async function checkFlashlightStatus() {
const isSwitchedOn = await CapacitorFlash.isSwitchedOn();
console.log('Flashlight status:', isSwitchedOn ? 'ON' : 'OFF');
}
Cette méthode bascule la lampe de poche, c'est-à-dire que si elle est allumée, elle s'éteindra, et vice versa.
import { CapacitorFlash } from '@capgo/capacitor-flash';
async function toggleFlashlight() {
await CapacitorFlash.toggle();
console.log('Flashlight toggled');
}
C'est tout ! Vous avez réussi à apprendre comment utiliser le package @capgo/capacitor-flash
dans votre application Ionic Capacitor pour contrôler la lampe de poche de votre appareil.