4.9 KiB
cordova-plugin-vibration
Ce plugin s'aligne avec le W3C vibration spécification http://www.w3.org/TR/vibration/
Ce plugin permet de vibrer l'appareil.
Ce plugin définit notamment des objets globauxnavigator.vibrate.
Bien que dans la portée globale, ils ne sont pas disponibles jusqu'après la deviceready événement.
document.addEventListener (« deviceready », onDeviceReady, false) ;
function onDeviceReady() {console.log(navigator.vibrate);}
Installation
Cordova plugin ajouter cordova-plugin-vibration
Plates-formes prises en charge
Navigator.VIBRATE,
Navigator.notification.VIBRATE - Amazon Fire OS - Android - BlackBerry 10 - Firefox OS - iOS - Windows Phone 7 et 8
navigator.notification.vibrateWithPattern,
navigator.notification.cancelVibration - Android - Windows Phone 8
vibrer (recommandée)
Cette fonction a trois différentes fonctionnalités basées sur les paramètres passés à elle.
Norme vibrer
Vibre l'appareil pendant un certain temps.
Navigator.VIBRATE(Time)
ou
Navigator.VIBRATE([time])
-temps: millisecondes à vibrer l'appareil. (Nombre)
Exemple
Vibrer pour 3 secondes navigator.vibrate(3000) ;
Vibrer pour 3 secondes navigator.vibrate([3000]) ;
iOS Quirks
-
temps: ne tient pas compte de la durée spécifiée et vibre pendant un temps prédéterminé.
navigator.vibrate(3000); // 3000 is ignored
Windows et les bizarreries de Blackberry
-
temps: temps Max est 5000ms (5 s) et heure min est de 1 ms
navigator.vibrate(8000); // will be truncated to 5000
Vibrer avec un motif (Android et Windows uniquement)
Vibre l'appareil avec un motif donné
Navigator.VIBRATE(Pattern) ;
- modèle: séquence de la durée (en millisecondes) pour lequel activer ou désactiver le vibreur. (Tableau de nombres)
Exemple
Vibreur pendant 1 seconde / / attendre 1 seconde / / vibrer pendant 3 secondes / / attendre 1 seconde / / vibrer pour 5 secondes navigator.vibrate ([1000, 1000, 3000, 1000, 5000]) ;
Windows Phone 8 Quirks
- chutes de VIBRATE(Pattern) retour à vibrent avec durée par défaut
Annuler les vibrations (ne pas de prise en charge d'iOS)
Immédiatement annule des vibrations en cours d'exécution.
Navigator.VIBRATE(0)
ou
Navigator.VIBRATE([])
ou
Navigator.VIBRATE([0])
En passant un paramètre de 0, un tableau vide, ou un tableau contenant un seul élément de valeur 0 annulera toute vibration.
*notification.VIBRATE (obsolète)
Vibre l'appareil pendant un certain temps.
Navigator.notification.VIBRATE(Time)
- temps: millisecondes à vibrer l'appareil. (Nombre)
Exemple
Vibrer pour 2,5 secondes navigator.notification.vibrate(2500) ;
iOS Quirks
-
temps: ne tient pas compte de la durée spécifiée et vibre pendant un temps prédéterminé.
Navigator.notification.VIBRATE() ; Navigator.notification.VIBRATE(2500) ; 2500 est ignoré
*notification.vibrateWithPattern (obsolète)
Vibre l'appareil avec un modèle donné.
navigator.notification.vibrateWithPattern (motif)
- modèle: séquence de la durée (en millisecondes) pour lequel activer ou désactiver le vibreur. (Tableau de nombres)
- répéter: optionnel index dans le tableau de configuration à laquelle commencer à répéter (répétera jusqu'à annulation), ou -1 pour aucune répétition (par défaut). (Nombre)
Exemple
Commencent immédiatement à vibrer / / vibrer de 100ms, / / attendre 100ms, / / vibrer pour 200ms, / / attendre 100ms, / / vibrer pour 400ms, / / attendre 100ms, / / vibrer pour 800ms, / / (ne pas répéter) navigator.notification.vibrateWithPattern ([0, 100, 100, 200, 100, 400, 100, 800]) ;
*notification.cancelVibration (obsolète)
Immédiatement annule des vibrations en cours d'exécution.
navigator.notification.cancelVibration()
- Remarque : en raison de l'alignement avec les spécifications w3c, les méthodes étoilées seront progressivement