Touchgui/plugins/org.apache.cordova.vibration/doc/fr/index.md

changeset 0
e8ccd40d0ef6
equal deleted inserted replaced
-1:000000000000 0:68c8ab9bca74
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
9
10 http://www.apache.org/licenses/LICENSE-2.0
11
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 -->
19
20 # org.apache.cordova.vibration
21
22 Ce plugin s'aligne avec le W3C vibration spécification http://www.w3.org/TR/vibration/
23
24 Ce plugin permet de vibrer l'appareil.
25
26 ## Installation
27
28 cordova plugin add org.apache.cordova.vibration
29
30
31 ## Plates-formes prises en charge
32
33 Navigator.VIBRATE
34 Navigator.notification.VIBRATE - Amazon Fire OS - Android - BlackBerry 10 - Firefox OS - iOS - Windows Phone 7 et 8
35
36 navigator.notification.vibrateWithPattern,
37 navigator.notification.cancelVibration - Android
38
39 ## vibrer (recommandée)
40
41 Cette fonction a trois différentes fonctionnalités basées sur les paramètres passés à elle.
42
43 ### Norme vibrer
44
45 Vibre l'appareil pendant un certain temps.
46
47 navigator.vibrate(time)
48
49
50 ou
51
52 navigator.vibrate([time])
53
54
55 -**temps**: millisecondes à vibrer l'appareil. *(Nombre)*
56
57 #### Exemple
58
59 // Vibrate for 3 seconds
60 navigator.vibrate(3000);
61
62 // Vibrate for 3 seconds
63 navigator.vibrate([3000]);
64
65
66 #### iOS Quirks
67
68 * **temps**: ne tient pas compte de la durée spécifiée et vibre pendant un temps prédéterminé.
69
70 navigator.vibrate(3000); // 3000 is ignored
71
72 #### Windows et les bizarreries de Blackberry
73
74 * **temps**: temps Max est 5000ms (5 s) et heure min est de 1 ms
75
76 navigator.vibrate(8000); // will be truncated to 5000
77
78 ### Vibrer avec un motif (Android et Windows uniquement)
79
80 Vibre l'appareil avec un motif donné
81
82 navigator.vibrate(pattern);
83
84
85 * **modèle**: séquence de la durée (en millisecondes) pour lequel activer ou désactiver le vibreur. *(Tableau de nombres)*
86
87 #### Exemple
88
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]);
95
96
97 ### Annuler les vibrations (ne pas de prise en charge d'iOS)
98
99 Immédiatement annule des vibrations en cours d'exécution.
100
101 navigator.vibrate(0)
102
103
104 ou
105
106 navigator.vibrate([])
107
108
109 ou
110
111 navigator.vibrate([0])
112
113
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.
115
116 ## *notification.VIBRATE (obsolète)
117
118 Vibre l'appareil pendant un certain temps.
119
120 navigator.notification.vibrate(time)
121
122
123 * **temps**: millisecondes à vibrer l'appareil. *(Nombre)*
124
125 ### Exemple
126
127 // Vibrate for 2.5 seconds
128 navigator.notification.vibrate(2500);
129
130
131 ### iOS Quirks
132
133 * **temps**: ne tient pas compte de la durée spécifiée et vibre pendant un temps prédéterminé.
134
135 navigator.notification.vibrate();
136 navigator.notification.vibrate(2500); // 2500 is ignored
137
138
139 ## *notification.vibrateWithPattern (obsolète)
140
141 Vibre l'appareil avec un modèle donné.
142
143 navigator.notification.vibrateWithPattern(pattern, repeat)
144
145
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)*
148
149 ### Exemple
150
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]);
161
162
163 ## *notification.cancelVibration (obsolète)
164
165 Immédiatement annule des vibrations en cours d'exécution.
166
167 navigator.notification.cancelVibration()
168
169
170 * Remarque : en raison de l'alignement avec les spécifications w3c, les méthodes étoilées seront progressivement

mercurial