This plugin allows you switch the Flashlight / Torch of your device on or off.
#### This is a fork of the original plugin cordova-plugin-flashlight
$ cordova plugin add community-cordova-plugin-flashlight
`
Bleeding edge version from Github:
`
$ cordova plugin add https://github.com/EddyVerbruggen/Flashlight-PhoneGap-Plugin
`
$3
Flashlight works with PhoneGap build too! Compatible with PhoneGap 3.0.0 and up.
Just add the following xml to your config.xml to always use the latest version of this plugin:
`xml
`
3. Usage
Since version 3.2.0 of this plugin you can pass in an intensity property
which needs to be anywhere between 0.0 and 1.0. __Only__ on iOS this will affect the
brightness of the torch.
`javascript
window.plugins.flashlight.available(function(isAvailable) {
if (isAvailable) {
// switch on
window.plugins.flashlight.switchOn(
function() {}, // optional success callback
function() {}, // optional error callback
{intensity: 0.3} // optional as well
);
// switch off after 3 seconds
setTimeout(function() {
window.plugins.flashlight.switchOff(); // success/error callbacks may be passed
}, 3000);
} else {
alert("Flashlight not available on this device");
}
});
`
As an alternative to switchOn and switchOff, you can use the toggle function
`javascript
window.plugins.flashlight.toggle(
function() {}, // optional success callback
function() {}, // optional error callback
{intensity: 0.3} // optional as well, used on iOS when switching on
);
`
To know if the flashlight is on or off you can call isSwitchedOn
`javascript
window.plugins.flashlight.isSwitchedOn(); // returns true/false
`
A hint for Android developers: you'll want to make sure the torch is switched off when the app is exited via the backbutton.
Otherwise, the camera may be locked so it can't be used by other apps:
`javascript
document.addEventListener("backbutton", function() {
// pass exitApp as callbacks to the switchOff method
window.plugins.flashlight.switchOff(exitApp, exitApp);
}, false);
function exitApp() {
navigator.app.exitApp();
}
``