Thu, 04 Jun 2015 14:50:33 +0200
Genesis of lecture sources for Droidcon Berlin 2015 in Postbahnhof.
1 <!---
2 Licensed to the Apache Software Foundation (ASF) under one
3 or more contributor license agreements. See the NOTICE file
4 distributed with this work for additional information
5 regarding copyright ownership. The ASF licenses this file
6 to you under the Apache License, Version 2.0 (the
7 "License"); you may not use this file except in compliance
8 with the License. You may obtain a copy of the License at
10 http://www.apache.org/licenses/LICENSE-2.0
12 Unless required by applicable law or agreed to in writing,
13 software distributed under the License is distributed on an
14 "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15 KIND, either express or implied. See the License for the
16 specific language governing permissions and limitations
17 under the License.
18 -->
20 # org.apache.cordova.vibration
22 Ce plugin s'aligne avec le W3C vibration spécification http://www.w3.org/TR/vibration/
24 Ce plugin permet de vibrer l'appareil.
26 ## Installation
28 cordova plugin add org.apache.cordova.vibration
31 ## Plates-formes prises en charge
33 Navigator.VIBRATE
34 Navigator.notification.VIBRATE - Amazon Fire OS - Android - BlackBerry 10 - Firefox OS - iOS - Windows Phone 7 et 8
36 navigator.notification.vibrateWithPattern,
37 navigator.notification.cancelVibration - Android
39 ## vibrer (recommandée)
41 Cette fonction a trois différentes fonctionnalités basées sur les paramètres passés à elle.
43 ### Norme vibrer
45 Vibre l'appareil pendant un certain temps.
47 navigator.vibrate(time)
50 ou
52 navigator.vibrate([time])
55 -**temps**: millisecondes à vibrer l'appareil. *(Nombre)*
57 #### Exemple
59 // Vibrate for 3 seconds
60 navigator.vibrate(3000);
62 // Vibrate for 3 seconds
63 navigator.vibrate([3000]);
66 #### iOS Quirks
68 * **temps**: ne tient pas compte de la durée spécifiée et vibre pendant un temps prédéterminé.
70 navigator.vibrate(3000); // 3000 is ignored
72 #### Windows et les bizarreries de Blackberry
74 * **temps**: temps Max est 5000ms (5 s) et heure min est de 1 ms
76 navigator.vibrate(8000); // will be truncated to 5000
78 ### Vibrer avec un motif (Android et Windows uniquement)
80 Vibre l'appareil avec un motif donné
82 navigator.vibrate(pattern);
85 * **modèle**: séquence de la durée (en millisecondes) pour lequel activer ou désactiver le vibreur. *(Tableau de nombres)*
87 #### Exemple
89 // Vibrate for 1 second
90 // Wait for 1 second
91 // Vibrate for 3 seconds
92 // Wait for 1 second
93 // Vibrate for 5 seconds
94 navigator.vibrate([1000, 1000, 3000, 1000, 5000]);
97 ### Annuler les vibrations (ne pas de prise en charge d'iOS)
99 Immédiatement annule des vibrations en cours d'exécution.
101 navigator.vibrate(0)
104 ou
106 navigator.vibrate([])
109 ou
111 navigator.vibrate([0])
114 En passant un paramètre de 0, un tableau vide, ou un tableau contenant un seul élément de valeur 0 annulera toute vibration.
116 ## *notification.VIBRATE (obsolète)
118 Vibre l'appareil pendant un certain temps.
120 navigator.notification.vibrate(time)
123 * **temps**: millisecondes à vibrer l'appareil. *(Nombre)*
125 ### Exemple
127 // Vibrate for 2.5 seconds
128 navigator.notification.vibrate(2500);
131 ### iOS Quirks
133 * **temps**: ne tient pas compte de la durée spécifiée et vibre pendant un temps prédéterminé.
135 navigator.notification.vibrate();
136 navigator.notification.vibrate(2500); // 2500 is ignored
139 ## *notification.vibrateWithPattern (obsolète)
141 Vibre l'appareil avec un modèle donné.
143 navigator.notification.vibrateWithPattern(pattern, repeat)
146 * **modèle**: séquence de la durée (en millisecondes) pour lequel activer ou désactiver le vibreur. *(Tableau de nombres)*
147 * **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)*
149 ### Exemple
151 // Immediately start vibrating
152 // vibrate for 100ms,
153 // wait for 100ms,
154 // vibrate for 200ms,
155 // wait for 100ms,
156 // vibrate for 400ms,
157 // wait for 100ms,
158 // vibrate for 800ms,
159 // (do not repeat)
160 navigator.notification.vibrateWithPattern([0, 100, 100, 200, 100, 400, 100, 800]);
163 ## *notification.cancelVibration (obsolète)
165 Immédiatement annule des vibrations en cours d'exécution.
167 navigator.notification.cancelVibration()
170 * Remarque : en raison de l'alignement avec les spécifications w3c, les méthodes étoilées seront progressivement