185 lines
4.9 KiB
Markdown
185 lines
4.9 KiB
Markdown
|
<!---
|
||
|
Licensed to the Apache Software Foundation (ASF) under one
|
||
|
or more contributor license agreements. See the NOTICE file
|
||
|
distributed with this work for additional information
|
||
|
regarding copyright ownership. The ASF licenses this file
|
||
|
to you under the Apache License, Version 2.0 (the
|
||
|
"License"); you may not use this file except in compliance
|
||
|
with the License. You may obtain a copy of the License at
|
||
|
|
||
|
http://www.apache.org/licenses/LICENSE-2.0
|
||
|
|
||
|
Unless required by applicable law or agreed to in writing,
|
||
|
software distributed under the License is distributed on an
|
||
|
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||
|
KIND, either express or implied. See the License for the
|
||
|
specific language governing permissions and limitations
|
||
|
under the License.
|
||
|
-->
|
||
|
|
||
|
# cordova-plugin-vibration
|
||
|
|
||
|
Questo plugin si allinea con il W3C vibrazione specifica http://www.w3.org/TR/vibration/
|
||
|
|
||
|
Questo plugin consente di vibrare il dispositivo.
|
||
|
|
||
|
Questo plugin definisce gli oggetti globali, tra cui `navigator.vibrate`.
|
||
|
|
||
|
Anche se in ambito globale, non sono disponibili fino a dopo l'evento `deviceready`.
|
||
|
|
||
|
document.addEventListener("deviceready", onDeviceReady, false);
|
||
|
function onDeviceReady() {
|
||
|
console.log(navigator.vibrate);
|
||
|
}
|
||
|
|
||
|
|
||
|
## Installazione
|
||
|
|
||
|
cordova plugin add cordova-plugin-vibration
|
||
|
|
||
|
|
||
|
## Piattaforme supportate
|
||
|
|
||
|
navigator.vibrate,
|
||
|
navigator.notification.vibrate - Amazon Fire OS - Android - BlackBerry 10 - Firefox OS - iOS - Windows Phone 7 and 8
|
||
|
|
||
|
navigator.notification.vibrateWithPattern,
|
||
|
navigator.notification.cancelVibration - Android - Windows Phone 8
|
||
|
|
||
|
## vibrare (consigliato)
|
||
|
|
||
|
Questa funzione ha tre differenti funzionalità basate su parametri passati ad esso.
|
||
|
|
||
|
### Standard vibrare
|
||
|
|
||
|
Vibra il dispositivo per un determinato periodo di tempo.
|
||
|
|
||
|
navigator.vibrate(time)
|
||
|
|
||
|
|
||
|
o
|
||
|
|
||
|
navigator.vibrate([time])
|
||
|
|
||
|
|
||
|
-**time**: millisecondi a vibrare il dispositivo. *(Numero)*
|
||
|
|
||
|
#### Esempio
|
||
|
|
||
|
// Vibrate for 3 seconds
|
||
|
navigator.vibrate(3000);
|
||
|
|
||
|
// Vibrate for 3 seconds
|
||
|
navigator.vibrate([3000]);
|
||
|
|
||
|
|
||
|
#### iOS stranezze
|
||
|
|
||
|
* **time**: ignora il tempo specificato e vibra per un tempo pre-impostato.
|
||
|
|
||
|
navigator.vibrate(3000); // 3000 is ignored
|
||
|
|
||
|
#### Windows e stranezze di Blackberry
|
||
|
|
||
|
* **time**: tempo Max 5000ms (5s) edè min tempo di 1ms
|
||
|
|
||
|
navigator.vibrate(8000); // will be truncated to 5000
|
||
|
|
||
|
### Vibrare con un pattern (Android e solo per Windows)
|
||
|
|
||
|
Vibra il dispositivo con un determinato modello
|
||
|
|
||
|
navigator.vibrate(pattern);
|
||
|
|
||
|
|
||
|
* **modello**: sequenza di durate (in millisecondi) per il quale attivare o disattivare il vibratore. *(Matrice di numeri)*
|
||
|
|
||
|
#### Esempio
|
||
|
|
||
|
// Vibrate for 1 second
|
||
|
// Wait for 1 second
|
||
|
// Vibrate for 3 seconds
|
||
|
// Wait for 1 second
|
||
|
// Vibrate for 5 seconds
|
||
|
navigator.vibrate([1000, 1000, 3000, 1000, 5000]);
|
||
|
|
||
|
|
||
|
#### Windows Phone 8 stranezze
|
||
|
|
||
|
* vibrate(pattern) cade indietro a vibrano con durata predefinita
|
||
|
|
||
|
### Annullare le vibrazioni (non supportata in iOS)
|
||
|
|
||
|
Annulla immediatamente qualsiasi vibrazione attualmente in esecuzione.
|
||
|
|
||
|
navigator.vibrate(0)
|
||
|
|
||
|
|
||
|
o
|
||
|
|
||
|
navigator.vibrate([])
|
||
|
|
||
|
|
||
|
o
|
||
|
|
||
|
navigator.vibrate([0])
|
||
|
|
||
|
|
||
|
Passa un parametro 0, matrice vuota o una matrice con un elemento di valore 0 annullerà eventuali vibrazioni.
|
||
|
|
||
|
## *notification.vibrate (deprecated)
|
||
|
|
||
|
Vibra il dispositivo per un determinato periodo di tempo.
|
||
|
|
||
|
navigator.notification.vibrate(time)
|
||
|
|
||
|
|
||
|
* **time**: millisecondi a vibrare il dispositivo. *(Numero)*
|
||
|
|
||
|
### Esempio
|
||
|
|
||
|
// Vibrate for 2.5 seconds
|
||
|
navigator.notification.vibrate(2500);
|
||
|
|
||
|
|
||
|
### iOS stranezze
|
||
|
|
||
|
* **time**: ignora il tempo specificato e vibra per un tempo pre-impostato.
|
||
|
|
||
|
navigator.notification.vibrate();
|
||
|
navigator.notification.vibrate(2500); // 2500 is ignored
|
||
|
|
||
|
|
||
|
## *Notification.vibrateWithPattern (obsoleto)
|
||
|
|
||
|
Vibra il dispositivo con un determinato modello.
|
||
|
|
||
|
navigator.notification.vibrateWithPattern(pattern, repeat)
|
||
|
|
||
|
|
||
|
* **modello**: sequenza di durate (in millisecondi) per il quale attivare o disattivare il vibratore. *(Matrice di numeri)*
|
||
|
* **repeat**: opzionale indice nell'array modello presso cui iniziare ripetendo (ripeterà finché non annullato), o -1 per nessuna ripetizione (impostazione predefinita). *(Numero)*
|
||
|
|
||
|
### Esempio
|
||
|
|
||
|
// Immediately start vibrating
|
||
|
// vibrate for 100ms,
|
||
|
// wait for 100ms,
|
||
|
// vibrate for 200ms,
|
||
|
// wait for 100ms,
|
||
|
// vibrate for 400ms,
|
||
|
// wait for 100ms,
|
||
|
// vibrate for 800ms,
|
||
|
// (do not repeat)
|
||
|
navigator.notification.vibrateWithPattern([0, 100, 100, 200, 100, 400, 100, 800]);
|
||
|
|
||
|
|
||
|
## *Notification.cancelVibration (obsoleto)
|
||
|
|
||
|
Annulla immediatamente qualsiasi vibrazione attualmente in esecuzione.
|
||
|
|
||
|
navigator.notification.cancelVibration()
|
||
|
|
||
|
|
||
|
* Nota - a causa di allineamento con le specifiche w3c, saranno essere ritirati i metodi speciali
|