4.9 KiB
cordova-plugin-vibration
Questo plugin si allinea con il W3C vibrazione specifica http://www.w3.org/TR/vibration/
Questo plugin consente di vibrare il dispositivo.
Questo plugin definisce gli oggetti globali, tra cui navigator.vibrate.
Anche se in ambito globale, non sono disponibili fino a dopo l'evento deviceready.
document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
console.log(navigator.vibrate);
}
Installazione
cordova plugin add cordova-plugin-vibration
Piattaforme supportate
navigator.vibrate,
navigator.notification.vibrate - Amazon Fire OS - Android - BlackBerry 10 - Firefox OS - iOS - Windows Phone 7 and 8
navigator.notification.vibrateWithPattern,
navigator.notification.cancelVibration - Android - Windows Phone 8
vibrare (consigliato)
Questa funzione ha tre differenti funzionalità basate su parametri passati ad esso.
Standard vibrare
Vibra il dispositivo per un determinato periodo di tempo.
navigator.vibrate(time)
o
navigator.vibrate([time])
-time: millisecondi a vibrare il dispositivo. (Numero)
Esempio
// Vibrate for 3 seconds
navigator.vibrate(3000);
// Vibrate for 3 seconds
navigator.vibrate([3000]);
iOS stranezze
-
time: ignora il tempo specificato e vibra per un tempo pre-impostato.
navigator.vibrate(3000); // 3000 is ignored
Windows e stranezze di Blackberry
-
time: tempo Max 5000ms (5s) edè min tempo di 1ms
navigator.vibrate(8000); // will be truncated to 5000
Vibrare con un pattern (Android e solo per Windows)
Vibra il dispositivo con un determinato modello
navigator.vibrate(pattern);
- modello: sequenza di durate (in millisecondi) per il quale attivare o disattivare il vibratore. (Matrice di numeri)
Esempio
// Vibrate for 1 second
// Wait for 1 second
// Vibrate for 3 seconds
// Wait for 1 second
// Vibrate for 5 seconds
navigator.vibrate([1000, 1000, 3000, 1000, 5000]);
Windows Phone 8 stranezze
- vibrate(pattern) cade indietro a vibrano con durata predefinita
Annullare le vibrazioni (non supportata in iOS)
Annulla immediatamente qualsiasi vibrazione attualmente in esecuzione.
navigator.vibrate(0)
o
navigator.vibrate([])
o
navigator.vibrate([0])
Passa un parametro 0, matrice vuota o una matrice con un elemento di valore 0 annullerà eventuali vibrazioni.
*notification.vibrate (deprecated)
Vibra il dispositivo per un determinato periodo di tempo.
navigator.notification.vibrate(time)
- time: millisecondi a vibrare il dispositivo. (Numero)
Esempio
// Vibrate for 2.5 seconds
navigator.notification.vibrate(2500);
iOS stranezze
-
time: ignora il tempo specificato e vibra per un tempo pre-impostato.
navigator.notification.vibrate(); navigator.notification.vibrate(2500); // 2500 is ignored
*Notification.vibrateWithPattern (obsoleto)
Vibra il dispositivo con un determinato modello.
navigator.notification.vibrateWithPattern(pattern, repeat)
- modello: sequenza di durate (in millisecondi) per il quale attivare o disattivare il vibratore. (Matrice di numeri)
- repeat: opzionale indice nell'array modello presso cui iniziare ripetendo (ripeterà finché non annullato), o -1 per nessuna ripetizione (impostazione predefinita). (Numero)
Esempio
// Immediately start vibrating
// vibrate for 100ms,
// wait for 100ms,
// vibrate for 200ms,
// wait for 100ms,
// vibrate for 400ms,
// wait for 100ms,
// vibrate for 800ms,
// (do not repeat)
navigator.notification.vibrateWithPattern([0, 100, 100, 200, 100, 400, 100, 800]);
*Notification.cancelVibration (obsoleto)
Annulla immediatamente qualsiasi vibrazione attualmente in esecuzione.
navigator.notification.cancelVibration()
- Nota - a causa di allineamento con le specifiche w3c, saranno essere ritirati i metodi speciali