Cordova-plugin-batterie-statut
Ce plugin fournit une implémentation d'une ancienne version de Batterie Status événements API.
Il ajoute les trois window
des événements :
- batterystatus
- batterycritical
- batterylow
Installation
cordova plugin add cordova-plugin-battery-status
batterystatus
L'évènement se déclenche lorsque le taux de charge de la batterie gagne ou perd au moins un pourcent, ou quand l'appareil est branché ou débranché.
Le gestionnaire est appelé avec un objet contenant deux propriétés :
-
level : le taux de charge de la batterie (0-100). (Number)
-
isPlugged : un booléen indiquant si l'appareil est en cours de chargement ou non. (Boolean)
Les applications doivent généralement utiliser window.addEventListener
pour attacher un écouteur d'événements après le deviceready
événement se déclenche.
Plates-formes supportées
- Amazon Fire OS
- iOS
- Android
- BlackBerry 10
- Windows Phone 7 et 8
- Windows (Windows Phone 8.1 uniquement)
- Paciarelli
- Firefox OS
Android et Amazon Fire OS bizarreries
- AVERTISSEMENT : l'Android + feu OS implémentations sont avides et utilisation prolongée s'évacuera pile de l'utilisateur.
Notes au sujet de Windows Phone 7 et 8
Windows Phone 7 ne fournit pas d'API native pour déterminer le niveau de la batterie, de ce fait la propriété level
n'est pas disponible. La propriété isPlugged
est quant à elle prise en charge.
Bizarreries de Windows
8.1 de Windows Phone ne prend pas de paramètre isPlugged
. Le level
paramètre is pris en charge.
Exemple
window.addEventListener("batterystatus", onBatteryStatus, false);
function onBatteryStatus(info) {
// Handle the online event
console.log("Level: " + info.level + " isPlugged: " + info.isPlugged);
}
batterycritical
L'évènement se déclenche lorsque le pourcentage de charge de la batterie a atteint un seuil critique. Cette valeur est spécifique à l'appareil.
Le gestionnaire batterycritical
est appelé avec un objet contenant deux propriétés :
-
level : le taux de charge de la batterie (0-100). (Number)
-
isPlugged : un booléen indiquant si l'appareil est en cours de chargement ou non. (Boolean)
Les applications devraient en général utiliser window.addEventListener
pour attacher un écouteur d'évènements, une fois l'évènement deviceready
déclenché.
Plates-formes supportées
- Amazon Fire OS
- iOS
- Android
- BlackBerry 10
- Paciarelli
- Firefox OS
- Windows (Windows Phone 8.1 uniquement)
Bizarreries de Windows
Windows Phone 8.1 tirera batterycritical
épreuve que l'État branché car il n'est pas supportée.
Exemple
window.addEventListener("batterycritical", onBatteryCritical, false);
function onBatteryCritical(info) {
// Handle the battery critical event
alert("Battery Level Critical " + info.level + "%\nRecharge Soon!");
}
batterylow
L'évènement se déclenche lorsque le pourcentage de charge de la batterie a atteint un niveau faible, cette valeur est spécifique à l'appareil.
Le gestionnaire batterylow
est appelé avec un objet contenant deux propriétés :
-
level : le taux de charge de la batterie (0-100). (Number)
-
isPlugged : un booléen indiquant si l'appareil est en cours de chargement ou non. (Boolean)
Les applications devraient en général utiliser window.addEventListener
pour attacher un écouteur d'évènements, une fois l'évènement deviceready
déclenché.
Plates-formes supportées
- Amazon Fire OS
- iOS
- Android
- BlackBerry 10
- Paciarelli
- Firefox OS
- Windows (Windows Phone 8.1 uniquement)
Bizarreries de Windows
Windows Phone 8.1 tirera batterylow
épreuve que l'État branché car il n'est pas supportée.
Exemple
window.addEventListener("batterylow", onBatteryLow, false);
function onBatteryLow(info) {
// Handle the battery low event
alert("Battery Level Low " + info.level + "%");
}