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
cantare @capgo/capacitor-flash Pacchetto
Il pacchetto @capgo/capacitor-flash
ti consente di accendere e spegnere la torcia del tuo dispositivo In questo tutorial, ti guideremo attraverso il processo di installazione e utilizzo di questo pacchetto nella tua app Ionic Capacitor
Per installare il pacchetto @capgo/capacitor-flash
, esegui il seguente comando nella directory principale del tuo progetto:
npm install @capgo/capacitor-flash
npx cap sync
Il pacchetto @capgo/capacitor-flash
funziona subito su iOS, quindi non è richiesta alcuna configurazione aggiuntiva
Per Android, devi dichiarare i permessi necessari nel file AndroidManifestxml
della tua app Aggiungi le seguenti righe all'interno del tag <manifest>
:
<uses-permission android:name="android.permission.CAMERA" />
<uses-feature android:name="android.hardware.camera" />
Il pacchetto @capgo/capacitor-flash
fornisce i seguenti metodi API:
Questo metodo verifica se la torcia è disponibile sul dispositivo
import { CapacitorFlash } from '@capgo/capacitor-flash';
async function checkFlashlightAvailability() {
const isAvailable = await CapacitorFlash.isAvailable();
console.log('Flashlight availability:', isAvailable);
}
Questo metodo accende la torcia del dispositivo Puoi passare opzioni per regolare l'intensità della torcia
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');
}
Questo metodo spegne la torcia del dispositivo
import { CapacitorFlash } from '@capgo/capacitor-flash';
async function switchOffFlashlight() {
await CapacitorFlash.switchOff();
console.log('Flashlight switched off');
}
Questo metodo verifica se la torcia è attualmente accesa o spenta
import { CapacitorFlash } from '@capgo/capacitor-flash';
async function checkFlashlightStatus() {
const isSwitchedOn = await CapacitorFlash.isSwitchedOn();
console.log('Flashlight status:', isSwitchedOn ? 'ON' : 'OFF');
}
Questo metodo attiva/disattiva la torcia, cioè, se è accesa, la spegnerà e viceversa
import { CapacitorFlash } from '@capgo/capacitor-flash';
async function toggleFlashlight() {
await CapacitorFlash.toggle();
console.log('Flashlight toggled');
}
Questo è tutto! Hai appreso con successo come utilizzare il pacchetto @capgo/capacitor-flash
nella tua app Ionic Capacitor per controllare la torcia del tuo dispositivo