<!---
    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

Ce plugin s'aligne avec le W3C vibration spécification http://www.w3.org/TR/vibration/

Ce plugin permet de vibrer l'appareil.

Ce plugin définit notamment des objets globaux`navigator.vibrate`.

Bien que dans la portée globale, ils ne sont pas disponibles jusqu'après la `deviceready` événement.

    document.addEventListener (« deviceready », onDeviceReady, false) ;
    function onDeviceReady() {console.log(navigator.vibrate);}
    

## Installation

    Cordova plugin ajouter cordova-plugin-vibration
    

## Plates-formes prises en charge

Navigator.VIBRATE,  
Navigator.notification.VIBRATE - Amazon Fire OS - Android - BlackBerry 10 - Firefox OS - iOS - Windows Phone 7 et 8

navigator.notification.vibrateWithPattern,  
navigator.notification.cancelVibration - Android - Windows Phone 8

## vibrer (recommandée)

Cette fonction a trois différentes fonctionnalités basées sur les paramètres passés à elle.

### Norme vibrer

Vibre l'appareil pendant un certain temps.

    Navigator.VIBRATE(Time)
    

ou

    Navigator.VIBRATE([time])
    

-**temps**: millisecondes à vibrer l'appareil. *(Nombre)*

#### Exemple

    Vibrer pour 3 secondes navigator.vibrate(3000) ;
    
    Vibrer pour 3 secondes navigator.vibrate([3000]) ;
    

#### iOS Quirks

*   **temps**: ne tient pas compte de la durée spécifiée et vibre pendant un temps prédéterminé.
    
    navigator.vibrate(3000); // 3000 is ignored

#### Windows et les bizarreries de Blackberry

*   **temps**: temps Max est 5000ms (5 s) et heure min est de 1 ms
    
    navigator.vibrate(8000); // will be truncated to 5000

### Vibrer avec un motif (Android et Windows uniquement)

Vibre l'appareil avec un motif donné

    Navigator.VIBRATE(Pattern) ;   
    

*   **modèle**: séquence de la durée (en millisecondes) pour lequel activer ou désactiver le vibreur. *(Tableau de nombres)*

#### Exemple

    Vibreur pendant 1 seconde / / attendre 1 seconde / / vibrer pendant 3 secondes / / attendre 1 seconde / / vibrer pour 5 secondes navigator.vibrate ([1000, 1000, 3000, 1000, 5000]) ;
    

#### Windows Phone 8 Quirks

*   chutes de VIBRATE(Pattern) retour à vibrent avec durée par défaut

### Annuler les vibrations (ne pas de prise en charge d'iOS)

Immédiatement annule des vibrations en cours d'exécution.

    Navigator.VIBRATE(0)
    

ou

    Navigator.VIBRATE([])
    

ou

    Navigator.VIBRATE([0])
    

En passant un paramètre de 0, un tableau vide, ou un tableau contenant un seul élément de valeur 0 annulera toute vibration.

## *notification.VIBRATE (obsolète)

Vibre l'appareil pendant un certain temps.

    Navigator.notification.VIBRATE(Time)
    

*   **temps**: millisecondes à vibrer l'appareil. *(Nombre)*

### Exemple

    Vibrer pour 2,5 secondes navigator.notification.vibrate(2500) ;
    

### iOS Quirks

*   **temps**: ne tient pas compte de la durée spécifiée et vibre pendant un temps prédéterminé.
    
        Navigator.notification.VIBRATE() ;
        Navigator.notification.VIBRATE(2500) ;   2500 est ignoré
        

## *notification.vibrateWithPattern (obsolète)

Vibre l'appareil avec un modèle donné.

    navigator.notification.vibrateWithPattern (motif)
    

*   **modèle**: séquence de la durée (en millisecondes) pour lequel activer ou désactiver le vibreur. *(Tableau de nombres)*
*   **répéter**: optionnel index dans le tableau de configuration à laquelle commencer à répéter (répétera jusqu'à annulation), ou -1 pour aucune répétition (par défaut). *(Nombre)*

### Exemple

    Commencent immédiatement à vibrer / / vibrer de 100ms, / / attendre 100ms, / / vibrer pour 200ms, / / attendre 100ms, / / vibrer pour 400ms, / / attendre 100ms, / / vibrer pour 800ms, / / (ne pas répéter) navigator.notification.vibrateWithPattern ([0, 100, 100, 200, 100, 400, 100, 800]) ;
    

## *notification.cancelVibration (obsolète)

Immédiatement annule des vibrations en cours d'exécution.

    navigator.notification.cancelVibration()
    

* Remarque : en raison de l'alignement avec les spécifications w3c, les méthodes étoilées seront progressivement