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

changeset 0
e8ccd40d0ef6
equal deleted inserted replaced
-1:000000000000 0:f0a24efb8338
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 Este plugin se alinea con la vibración W3C especificación http://www.w3.org/TR/vibration/
23
24 Este plugin proporciona una manera de vibrar el dispositivo.
25
26 ## Instalación
27
28 cordova plugin add org.apache.cordova.vibration
29
30
31 ## Plataformas soportadas
32
33 Navigator.Vibrate
34 Navigator.Notification.Vibrate - Amazon fuego OS - sistema operativo Android - BlackBerry 10 - Firefox - iOS - Windows Phone 7 y 8
35
36 navigator.notification.vibrateWithPattern,
37 navigator.notification.cancelVibration - Android
38
39 ## vibrar (recomendado)
40
41 Esta función tiene tres diferentes funcionalidades basadas en los parámetros pasados a él.
42
43 ### Estándar de vibrar
44
45 Vibra el dispositivo para una cantidad dada de tiempo.
46
47 navigator.vibrate(time)
48
49
50 o
51
52 navigator.vibrate([time])
53
54
55 -**tiempo**: milisegundos a vibrar el dispositivo. *(Número)*
56
57 #### Ejemplo
58
59 // Vibrate for 3 seconds
60 navigator.vibrate(3000);
61
62 // Vibrate for 3 seconds
63 navigator.vibrate([3000]);
64
65
66 #### iOS rarezas
67
68 * **time**: ignora el tiempo especificado y vibra por un tiempo preestablecido.
69
70 navigator.vibrate(3000); // 3000 is ignored
71
72 #### Windows y rarezas de Blackberry
73
74 * **tiempo**: tiempo máximo es 5000ms (5s) y min tiempo 1ms
75
76 navigator.vibrate(8000); // will be truncated to 5000
77
78 ### Vibrar con un patrón (Android y Windows solamente)
79
80 Vibra el dispositivo con un patrón determinado
81
82 navigator.vibrate(pattern);
83
84
85 * **patrón**: secuencia de duraciones (en milisegundos) que desea activar o desactivar el vibrador. *(Matriz de números)*
86
87 #### Ejemplo
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 ### Cancelar vibración (no soportada en iOS)
98
99 Inmediatamente se cancela cualquier vibración actualmente en ejecución.
100
101 navigator.vibrate(0)
102
103
104 o
105
106 navigator.vibrate([])
107
108
109 o
110
111 navigator.vibrate([0])
112
113
114 Pasando en un parámetro de 0, una matriz vacía o una matriz con un elemento de valor 0 se cancelará cualquier vibraciones.
115
116 ## *Notification.Vibrate (obsoleto)
117
118 Vibra el dispositivo para una cantidad dada de tiempo.
119
120 navigator.notification.vibrate(time)
121
122
123 * **tiempo**: milisegundos a vibrar el dispositivo. *(Número)*
124
125 ### Ejemplo
126
127 // Vibrate for 2.5 seconds
128 navigator.notification.vibrate(2500);
129
130
131 ### iOS rarezas
132
133 * **time**: ignora el tiempo especificado y vibra por un tiempo preestablecido.
134
135 navigator.notification.vibrate();
136 navigator.notification.vibrate(2500); // 2500 is ignored
137
138
139 ## *Notification.vibrateWithPattern (obsoleto)
140
141 Vibra el dispositivo con un patrón determinado.
142
143 navigator.notification.vibrateWithPattern(pattern, repeat)
144
145
146 * **patrón**: secuencia de duraciones (en milisegundos) que desea activar o desactivar el vibrador. *(Matriz de números)*
147 * **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)*
148
149 ### Ejemplo
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 (obsoleto)
164
165 Inmediatamente se cancela cualquier vibración actualmente en ejecución.
166
167 navigator.notification.cancelVibration()
168
169
170 * Nota: debido a la alineación con la especificación del w3c, los métodos favoritos a ser eliminados

mercurial