Este complemento proporciona una forma de hacer vibrar el dispositivo. Su API se alinea con la especificación de vibración W3C en http://www.w3.org/TR/vibration/
El complemento define un objeto/método global. navigator.vibrate
Aunque está en el ámbito global, no está disponible hasta después del deviceready
evento.
document.addEventListener("deviceready", onDeviceReady, false); function onDeviceReady() { console.log(navigator.vibrate); }
navigator.vibrate
Esta función tiene tres funcionalidades diferentes según los parámetros que se le pasan:
confirmCallback
Hace vibrar el dispositivo durante un período de tiempo determinado.navigator.vibrate(time)
o navigator.vibrate([time])
- tiempo: Milisegundos para hacer vibrar el dispositivo.(Number)
Ejemplo
// Vibrate for 3 seconds navigator.vibrate(3000); // Vibrate for 3 seconds navigator.vibrate([3000]);
Nota: Las llamadas a navigator.vibrate
volverán inmediatamente false
si el usuario aún no ha tocado el marco o cualquier marco incrustado.
Vibrate with a pattern
Hace vibrar el dispositivo con un patrón determinado.navigator.vibrate(pattern);
- patrón: Secuencia de duraciones (en milisegundos) durante las cuales encender o apagar el vibrador.(Array of Number)
Ejemplo
// 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]);
Cancel vibration
Cancela inmediatamente cualquier vibración que se esté ejecutando actualmente.
navigator.vibrate(0)
o
navigator.vibrate([])
o
navigator.vibrate([0])
Pasar un parámetro de 0, una matriz vacía o una matriz con un elemento de valor 0 cancelará cualquier vibración.