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 Questo plugin si allinea con il W3C vibrazione specifica http://www.w3.org/TR/vibration/
24 Questo plugin consente di vibrare il dispositivo.
26 ## Installazione
28 cordova plugin add org.apache.cordova.vibration
31 ## Piattaforme supportate
33 Navigator.vibrate
34 Navigator.Notification.vibrate - Amazon fuoco OS - OS di Firefox - 10 BlackBerry - Android - iOS - Windows Phone 7 e 8
36 navigator.notification.vibrateWithPattern,
37 navigator.notification.cancelVibration - Android
39 ## vibrare (consigliato)
41 Questa funzione ha tre differenti funzionalità basate su parametri passati ad esso.
43 ### Standard vibrare
45 Vibra il dispositivo per un determinato periodo di tempo.
47 navigator.vibrate(time)
50 o
52 navigator.vibrate([time])
55 -**tempo**: millisecondi a vibrare il dispositivo. *(Numero)*
57 #### Esempio
59 // Vibrate for 3 seconds
60 navigator.vibrate(3000);
62 // Vibrate for 3 seconds
63 navigator.vibrate([3000]);
66 #### iOS stranezze
68 * **tempo**: ignora il tempo specificato e vibra per un tempo pre-impostato.
70 navigator.vibrate(3000); // 3000 is ignored
72 #### Windows e stranezze di Blackberry
74 * **tempo**: tempo Max 5000ms (5s) edè min tempo di 1ms
76 navigator.vibrate(8000); // will be truncated to 5000
78 ### Vibrare con un pattern (Android e solo per Windows)
80 Vibra il dispositivo con un determinato modello
82 navigator.vibrate(pattern);
85 * **modello**: sequenza di durate (in millisecondi) per il quale attivare o disattivare il vibratore. *(Matrice di numeri)*
87 #### Esempio
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 ### Annullare le vibrazioni (non supportata in iOS)
99 Annulla immediatamente qualsiasi vibrazione attualmente in esecuzione.
101 navigator.vibrate(0)
104 o
106 navigator.vibrate([])
109 o
111 navigator.vibrate([0])
114 Passa un parametro 0, matrice vuota o una matrice con un elemento di valore 0 annullerà eventuali vibrazioni.
116 ## *Notification.vibrate (obsoleto)
118 Vibra il dispositivo per un determinato periodo di tempo.
120 navigator.notification.vibrate(time)
123 * **tempo**: millisecondi a vibrare il dispositivo. *(Numero)*
125 ### Esempio
127 // Vibrate for 2.5 seconds
128 navigator.notification.vibrate(2500);
131 ### iOS stranezze
133 * **tempo**: ignora il tempo specificato e vibra per un tempo pre-impostato.
135 navigator.notification.vibrate();
136 navigator.notification.vibrate(2500); // 2500 is ignored
139 ## *Notification.vibrateWithPattern (obsoleto)
141 Vibra il dispositivo con un determinato modello.
143 navigator.notification.vibrateWithPattern(pattern, repeat)
146 * **modello**: sequenza di durate (in millisecondi) per il quale attivare o disattivare il vibratore. *(Matrice di numeri)*
147 * **ripetere**: opzionale indice nell'array modello presso cui iniziare ripetendo (ripeterà finché non annullato), o -1 per nessuna ripetizione (impostazione predefinita). *(Numero)*
149 ### Esempio
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 Annulla immediatamente qualsiasi vibrazione attualmente in esecuzione.
167 navigator.notification.cancelVibration()
170 * Nota - a causa di allineamento con le specifiche w3c, saranno essere ritirati i metodi speciali