diff -r 000000000000 -r e8ccd40d0ef6 Touchgui/plugins/org.apache.cordova.vibration/doc/pl/index.md --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Touchgui/plugins/org.apache.cordova.vibration/doc/pl/index.md Thu Jun 04 14:50:33 2015 +0200 @@ -0,0 +1,170 @@ + + +# org.apache.cordova.vibration + +Ten plugin wyrównuje z http://www.w3.org/TR/vibration/ specyfikacji W3C wibracji + +Ten plugin umożliwia wibracje urządzenia. + +## Instalacja + + cordova plugin add org.apache.cordova.vibration + + +## Obsługiwane platformy + +Navigator.vibrate +Navigator.Notification.vibrate - Amazon ogień OS - OS Android - BlackBerry 10 - Firefox - iOS - Windows Phone 7 i 8 + +navigator.notification.vibrateWithPattern, +navigator.notification.cancelVibration - Android + +## wibracje (zalecane) + +Funkcja ta ma trzy różne funkcje na podstawie parametrów przekazywanych do niej. + +### Standardowe wibracje + +Wibruje urządzenie na określoną ilość czasu. + + navigator.vibrate(time) + + +lub + + navigator.vibrate([time]) + + +-**czas**: milisekund wibracje urządzenia. *(Liczba)* + +#### Przykład + + // Vibrate for 3 seconds + navigator.vibrate(3000); + + // Vibrate for 3 seconds + navigator.vibrate([3000]); + + +#### Dziwactwa iOS + +* **czas**: ignoruje określony czas i wibruje na wstępnie określoną ilość czasu. + + Navigator.vibrate(3000); 3000 jest ignorowany + +#### Windows i Blackberry dziwactwa + +* **czas**: Max czas jest 5000ms (5s) i min czas 1ms + + navigator.vibrate(8000); // will be truncated to 5000 + +### Wibracje z wzorem (Android i Windows tylko) + +Wibruje urządzenie z danego wzoru + + navigator.vibrate(pattern); + + +* **wzór**: sekwencja czas trwania (w milisekundach), dla której chcesz włączyć lub wyłączyć wibrator. *(Tablica liczb)* + +#### Przykład + + // 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]); + + +### Anuluj wibracji (nieobsługiwane w iOS) + +Niezwłocznie anuluje aktualnie uruchomione wibracje. + + navigator.vibrate(0) + + +lub + + navigator.vibrate([]) + + +lub + + navigator.vibrate([0]) + + +Przekazując parametr 0, pustą tablicę lub tablicy z jednym z elementów wartości 0 spowoduje anulowanie wibracji. + +## *Notification.vibrate (przestarzałe) + +Wibruje urządzenie na określoną ilość czasu. + + navigator.notification.vibrate(time) + + +* **czas**: milisekund wibracje urządzenia. *(Liczba)* + +### Przykład + + // Vibrate for 2.5 seconds + navigator.notification.vibrate(2500); + + +### Dziwactwa iOS + +* **czas**: ignoruje określony czas i wibruje na wstępnie określoną ilość czasu. + + navigator.notification.vibrate(); + navigator.notification.vibrate(2500); // 2500 is ignored + + +## *Notification.vibrateWithPattern (przestarzałe) + +Wibruje urządzenie z danego wzoru. + + navigator.notification.vibrateWithPattern(pattern, repeat) + + +* **wzór**: sekwencja czas trwania (w milisekundach), dla której chcesz włączyć lub wyłączyć wibrator. *(Tablica liczb)* +* **Powtórz**: opcjonalny indeks do tablicy wzór który zacząć powtarzać (będzie powtarzać do momentu anulowane), lub -1 nie powtarzania (domyślnie). *(Liczba)* + +### Przykład + + // 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 (przestarzałe) + +Niezwłocznie anuluje aktualnie uruchomione wibracje. + + navigator.notification.cancelVibration() + + +* Uwaga - ze względu na dostosowanie specyfikacji w3c, oznaczonych gwiazdką metody zostaną wycofane \ No newline at end of file