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 Este plugin se alinea con la vibración W3C especificación http://www.w3.org/TR/vibration/
24 Este plugin proporciona una manera de vibrar el dispositivo.
26 ## Instalación
28 cordova plugin add org.apache.cordova.vibration
31 ## Plataformas soportadas
33 Navigator.Vibrate
34 Navigator.Notification.Vibrate - Amazon fuego OS - sistema operativo Android - BlackBerry 10 - Firefox - iOS - Windows Phone 7 y 8
36 navigator.notification.vibrateWithPattern,
37 navigator.notification.cancelVibration - Android
39 ## vibrar (recomendado)
41 Esta función tiene tres diferentes funcionalidades basadas en los parámetros pasados a él.
43 ### Estándar de vibrar
45 Vibra el dispositivo para una cantidad dada de tiempo.
47 navigator.vibrate(time)
50 o
52 navigator.vibrate([time])
55 -**tiempo**: milisegundos a vibrar el dispositivo. *(Número)*
57 #### Ejemplo
59 // Vibrate for 3 seconds
60 navigator.vibrate(3000);
62 // Vibrate for 3 seconds
63 navigator.vibrate([3000]);
66 #### iOS rarezas
68 * **time**: ignora el tiempo especificado y vibra por un tiempo preestablecido.
70 navigator.vibrate(3000); // 3000 is ignored
72 #### Windows y rarezas de Blackberry
74 * **tiempo**: tiempo máximo es 5000ms (5s) y min tiempo 1ms
76 navigator.vibrate(8000); // will be truncated to 5000
78 ### Vibrar con un patrón (Android y Windows solamente)
80 Vibra el dispositivo con un patrón determinado
82 navigator.vibrate(pattern);
85 * **patrón**: secuencia de duraciones (en milisegundos) que desea activar o desactivar el vibrador. *(Matriz de números)*
87 #### Ejemplo
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 ### Cancelar vibración (no soportada en iOS)
99 Inmediatamente se cancela cualquier vibración actualmente en ejecución.
101 navigator.vibrate(0)
104 o
106 navigator.vibrate([])
109 o
111 navigator.vibrate([0])
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.
116 ## *Notification.Vibrate (obsoleto)
118 Vibra el dispositivo para una cantidad dada de tiempo.
120 navigator.notification.vibrate(time)
123 * **tiempo**: milisegundos a vibrar el dispositivo. *(Número)*
125 ### Ejemplo
127 // Vibrate for 2.5 seconds
128 navigator.notification.vibrate(2500);
131 ### iOS rarezas
133 * **time**: ignora el tiempo especificado y vibra por un tiempo preestablecido.
135 navigator.notification.vibrate();
136 navigator.notification.vibrate(2500); // 2500 is ignored
139 ## *Notification.vibrateWithPattern (obsoleto)
141 Vibra el dispositivo con un patrón determinado.
143 navigator.notification.vibrateWithPattern(pattern, repeat)
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)*
149 ### Ejemplo
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 (obsoleto)
165 Inmediatamente se cancela cualquier vibración actualmente en ejecución.
167 navigator.notification.cancelVibration()
170 * Nota: debido a la alineación con la especificación del w3c, los métodos favoritos a ser eliminados