4.9 KiB
cordova-plugin-vibration
Este plugin se alinea con la vibración W3C especificación http://www.w3.org/TR/vibration/
Este plugin proporciona una manera de vibrar el dispositivo.
Este plugin define objetos globales incluyendonavigator.vibrate
.
Aunque en el ámbito global, no están disponibles hasta después de la deviceready
evento.
document.addEventListener ("deviceready", onDeviceReady, false);
function onDeviceReady() {console.log(navigator.vibrate)};
Instalación
Cordova plugin agregar cordova-plugin-vibration
Plataformas soportadas
Navigator.Vibrate,
Navigator.Notification.Vibrate - Amazon fuego OS - sistema operativo Android - BlackBerry 10 - Firefox - iOS - Windows Phone 7 y 8
navigator.notification.vibrateWithPattern,
navigator.notification.cancelVibration - Android - Windows Phone 8
vibrar (recomendado)
Esta función tiene tres diferentes funcionalidades basadas en los parámetros pasados a él.
Estándar de vibrar
Vibra el dispositivo para una cantidad dada de tiempo.
Navigator.Vibrate(Time)
o
Navigator.Vibrate([time])
-tiempo: milisegundos a vibrar el dispositivo. (Número)
Ejemplo
Vibrar para navigator.vibrate(3000) 3 segundos;
Vibrar para navigator.vibrate([3000]) 3 segundos;
iOS rarezas
-
time: ignora el tiempo especificado y vibra por un tiempo preestablecido.
navigator.vibrate(3000); // 3000 is ignored
Windows y rarezas de Blackberry
-
tiempo: tiempo máximo es 5000ms (5s) y min tiempo 1ms
navigator.vibrate(8000); // will be truncated to 5000
Vibrar con un patrón (Android y Windows solamente)
Vibra el dispositivo con un patrón determinado
Navigator.Vibrate(Pattern);
- patrón: secuencia de duraciones (en milisegundos) que desea activar o desactivar el vibrador. (Matriz de números)
Ejemplo
Vibrar durante 1 segundo / / esperar 1 segundo / / vibrar durante 3 segundos / / esperar 1 segundo / / vibrar por 5 segundos navigator.vibrate ([1000, 1000, 3000, 1000, 5000]);
Windows Phone 8 rarezas
- Vibrate(Pattern) caídas detrás en vibración con duración predeterminada
Cancelar vibración (no soportada en iOS)
Inmediatamente se cancela cualquier vibración actualmente en ejecución.
Navigator.Vibrate(0)
o
Navigator.Vibrate([])
o
Navigator.Vibrate([0])
Pasando en un parámetro de 0, una matriz vacía o una matriz con un elemento de valor 0 se cancelará cualquier vibraciones.
*Notification.Vibrate (obsoleto)
Vibra el dispositivo para una cantidad dada de tiempo.
Navigator.Notification.Vibrate(Time)
- tiempo: milisegundos a vibrar el dispositivo. (Número)
Ejemplo
Vibrar por 2.5 segundos navigator.notification.vibrate(2500);
iOS rarezas
-
tiempo: ignora el tiempo especificado y vibra durante un tiempo preestablecido.
Navigator.Notification.Vibrate(); Navigator.Notification.Vibrate(2500); 2500 se omite
*Notification.vibrateWithPattern (obsoleto)
Vibra el dispositivo con un patrón determinado.
navigator.notification.vibrateWithPattern (patrón de repetición)
- patrón: secuencia de duraciones (en milisegundos) que desea activar o desactivar el vibrador. (Matriz de números)
- repito: índice opcional en la matriz de patrón en el cual comenzar repitiendo (se repite hasta que se cancele), o -1 para la no repetición (por defecto). (Número)
Ejemplo
Inmediatamente comenzar a vibrar / / vibrar de 100ms, / / espera a 100ms, / / vibrar de 200ms, / / esperar 100ms, / / vibrar para 400ms, / / esperar 100ms, / / vibrar para 800ms, / / (no repetir) navigator.notification.vibrateWithPattern ([0, 100, 100, 200, 100, 400, 100, 800]);
*Notification.cancelVibration (obsoleto)
Inmediatamente se cancela cualquier vibración actualmente en ejecución.
navigator.notification.cancelVibration()
- Nota: debido a la alineación con la especificación del w3c, los métodos favoritos a ser eliminados