tree: 0e67a847310eac30118928f47d5b03fa99290b40 [path history] [tgz]
  1. index.md
  2. README.md
doc/es/README.md

cordova-plugin-vibration

Build Status

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 add cordova-plugin-vibration

Plataformas soportadas

navigator.vibrate,
navigator.notification.vibrate - Amazon Fire OS - Android - BlackBerry 10 - Firefox OS - iOS - Windows Phone 7 and 8 - Windows (Windows Phone 8.1 devices only)

navigator.notification.vibrateWithPattern
navigator.notification.cancelVibration - Android - Windows Phone 8 - Windows (Windows Phone 8.1 devices only)

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

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

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

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

// 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 rarezas

  • Vibrate(Pattern) caídas detrás en vibración con duración predeterminada

Windows 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

  • time: ignora el tiempo especificado y vibra por un tiempo preestablecido.

    navigator.notification.vibrate();
    navigator.notification.vibrate(2500);   // 2500 is ignored
    

*Notification.vibrateWithPattern (obsoleto)

Vibra el dispositivo con un patrón determinado.

navigator.notification.vibrateWithPattern(pattern, repeat)
  • 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

// 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)

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