Este complemento se alinea con la especificación de vibración W3C http://www.w3.org/TR/vibration/

Este complemento proporciona una forma de hacer vibrar el dispositivo.

Este complemento define objetos globales que incluyen navigator.vibrate.

Aunque en el ámbito global, no están disponibles hasta después de la deviceready evento.

document.addEventListener("deviceready", onDeviceReady,false);functiononDeviceReady()
    console.log(navigator.vibrate);

Instalación

cordova plugin add cordova-plugin-vibration

Plataformas compatibles

navegador.vibrar

  • Androide
  • iOS
  • ventanas

La vista web de Android (nivel de API 19 y superior) admite la API de vibración W3C de forma nativa y, por lo tanto, se eliminó la implementación específica de Android de este complemento.

vibrar

Esta función tiene tres funcionalidades diferentes basadas en los parámetros que se le pasan.

vibración estándar

Hace vibrar el dispositivo durante un tiempo determinado.

navigator.vibrate(time)

o

navigator.vibrate([time])

tiempo: Milisegundos para hacer vibrar el dispositivo. (Número)

Ejemplo

// Vibrate for 3 seconds
navigator.vibrate(3000);// Vibrate for 3 seconds
navigator.vibrate([3000]);

peculiaridades de Android

Llamadas a navigator.vibrate regresará inmediatamente false si el usuario aún no ha tocado el marco o cualquier marco incrustado. Consulte https://issues.apache.org/jira/browse/CB-14022 para obtener más información.

peculiaridades de iOS

  • tiempo: Ignora el tiempo especificado y vibra durante un tiempo predeterminado.

    navigator.vibrate(3000);// 3000 is ignored

    Peculiaridades de Windows

  • tiempo: El tiempo máximo es 5000ms (5s) y el tiempo mínimo es 1ms

navigator.vibrate(8000);// will be truncated to 5000

Vibrar con un patrón (solo Android y Windows)

Hace vibrar el dispositivo con un patrón dado

navigator.vibrate(pattern);
  • patrón: Secuencia de duraciones (en milisegundos) para encender o apagar el vibrador. (matriz de números)

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]);

Cancelar vibración (no compatible con iOS)

Cancela inmediatamente cualquier vibración que se esté ejecutando actualmente.

navigator.vibrate(0)

o

navigator.vibrate([])

o

navigator.vibrate([0])

Pasando un parámetro de 0, un vacío arrayo un array con un elemento de valor 0 cancelará cualquier vibración.