<!---
    Licensed to the Apache Software Foundation (ASF) under one
    or more contributor license agreements.  See the NOTICE file
    distributed with this work for additional information
    regarding copyright ownership.  The ASF licenses this file
    to you under the Apache License, Version 2.0 (the
    "License"); you may not use this file except in compliance
    with the License.  You may obtain a copy of the License at

      http://www.apache.org/licenses/LICENSE-2.0

    Unless required by applicable law or agreed to in writing,
    software distributed under the License is distributed on an
    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
    KIND, either express or implied.  See the License for the
    specific language governing permissions and limitations
    under the License.
-->

# 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 incluyendo`navigator.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