diff -r 000000000000 -r e8ccd40d0ef6 Touchgui/plugins/org.apache.cordova.vibration/doc/ru/index.md --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Touchgui/plugins/org.apache.cordova.vibration/doc/ru/index.md Thu Jun 04 14:50:33 2015 +0200 @@ -0,0 +1,170 @@ + + +# org.apache.cordova.vibration + +Этот плагин выравнивает с http://www.w3.org/TR/vibration/ спецификации W3C вибрации + +Этот плагин позволяет вибрировать устройство. + +## Установка + + cordova plugin add org.apache.cordova.vibration + + +## Поддерживаемые платформы + +Navigator.Vibrate +Navigator.Notification.Vibrate - Amazon Fire OS - Android - BlackBerry 10 - Firefox OS - iOS - Windows Phone 7 и 8 + +navigator.notification.vibrateWithPattern, +navigator.notification.cancelVibration - Android + +## вибрировать (рекомендуется) + +Эта функция имеет три различных функций, на основе параметров, передаваемых ему. + +### Стандарт вибрировать + +Устройство вибрирует за определенное количество времени. + + navigator.vibrate(time) + + +или + + navigator.vibrate([time]) + + +-**time**: Сколько миллисекунд будет вибрировать устройство. *(Число)* + +#### Пример + + // Vibrate for 3 seconds + navigator.vibrate(3000); + + // Vibrate for 3 seconds + navigator.vibrate([3000]); + + +#### Особенности iOS + +* **time**: игнорирует указанное время и вибрирует предопределенный отрезок времени. + + navigator.vibrate(3000); // 3000 is ignored + +#### Окна и Blackberry причуды + +* **время**: время Макс 5000ms (5с) и минимальное время 1 мс + + navigator.vibrate(8000); // will be truncated to 5000 + +### Вибрировать с узором (Android и Windows только) + +Вибрирует на устройства с заданным шаблоном + + navigator.vibrate(pattern); + + +* **шаблон**: последовательность длительностей (в миллисекундах), для которого требуется включить или выключить вибростол. *(Массив из чисел)* + +#### Пример + + // 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]); + + +### Отмена вибрации (не поддерживается в iOS) + +Немедленно отменяет любые выполняющиеся вибрации. + + navigator.vibrate(0) + + +или + + navigator.vibrate([]) + + +или + + navigator.vibrate([0]) + + +Проходя в параметре 0, пустой массив, или массив с одним элементом значения 0 будет отменить любые вибрации. + +## *Notification.Vibrate (устарело) + +Устройство вибрирует за определенное количество времени. + + navigator.notification.vibrate(time) + + +* **time**: Сколько миллисекунд будет вибрировать устройство. *(Число)* + +### Пример + + // Vibrate for 2.5 seconds + navigator.notification.vibrate(2500); + + +### Особенности iOS + +* **time**: игнорирует указанное время и вибрирует предопределенный отрезок времени. + + navigator.notification.vibrate(); + navigator.notification.vibrate(2500); // 2500 is ignored + + +## *Notification.vibrateWithPattern (устарело) + +Вибрирует на устройства с заданным шаблоном. + + navigator.notification.vibrateWithPattern(pattern, repeat) + + +* **шаблон**: последовательность длительностей (в миллисекундах), для которого требуется включить или выключить вибростол. *(Массив из чисел)* +* **повторяю**: дополнительный индекс в массиве шаблон для начала повторять (будет повторять пока не отменен), или -1 для не повторения (по умолчанию). *(Число)* + +### Пример + + // 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 (устарело) + +Немедленно отменяет любые выполняющиеся вибрации. + + navigator.notification.cancelVibration() + + +* Обратите внимание - из-за соответствие спецификации w3c, Избранные методы будут поэтапно \ No newline at end of file