1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/Touchgui/plugins/org.apache.cordova.vibration/doc/ru/index.md Thu Jun 04 14:50:33 2015 +0200
1.3 @@ -0,0 +1,170 @@
1.4 +<!---
1.5 + Licensed to the Apache Software Foundation (ASF) under one
1.6 + or more contributor license agreements. See the NOTICE file
1.7 + distributed with this work for additional information
1.8 + regarding copyright ownership. The ASF licenses this file
1.9 + to you under the Apache License, Version 2.0 (the
1.10 + "License"); you may not use this file except in compliance
1.11 + with the License. You may obtain a copy of the License at
1.12 +
1.13 + http://www.apache.org/licenses/LICENSE-2.0
1.14 +
1.15 + Unless required by applicable law or agreed to in writing,
1.16 + software distributed under the License is distributed on an
1.17 + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
1.18 + KIND, either express or implied. See the License for the
1.19 + specific language governing permissions and limitations
1.20 + under the License.
1.21 +-->
1.22 +
1.23 +# org.apache.cordova.vibration
1.24 +
1.25 +Этот плагин выравнивает с http://www.w3.org/TR/vibration/ спецификации W3C вибрации
1.26 +
1.27 +Этот плагин позволяет вибрировать устройство.
1.28 +
1.29 +## Установка
1.30 +
1.31 + cordova plugin add org.apache.cordova.vibration
1.32 +
1.33 +
1.34 +## Поддерживаемые платформы
1.35 +
1.36 +Navigator.Vibrate
1.37 +Navigator.Notification.Vibrate - Amazon Fire OS - Android - BlackBerry 10 - Firefox OS - iOS - Windows Phone 7 и 8
1.38 +
1.39 +navigator.notification.vibrateWithPattern,
1.40 +navigator.notification.cancelVibration - Android
1.41 +
1.42 +## вибрировать (рекомендуется)
1.43 +
1.44 +Эта функция имеет три различных функций, на основе параметров, передаваемых ему.
1.45 +
1.46 +### Стандарт вибрировать
1.47 +
1.48 +Устройство вибрирует за определенное количество времени.
1.49 +
1.50 + navigator.vibrate(time)
1.51 +
1.52 +
1.53 +или
1.54 +
1.55 + navigator.vibrate([time])
1.56 +
1.57 +
1.58 +-**time**: Сколько миллисекунд будет вибрировать устройство. *(Число)*
1.59 +
1.60 +#### Пример
1.61 +
1.62 + // Vibrate for 3 seconds
1.63 + navigator.vibrate(3000);
1.64 +
1.65 + // Vibrate for 3 seconds
1.66 + navigator.vibrate([3000]);
1.67 +
1.68 +
1.69 +#### Особенности iOS
1.70 +
1.71 +* **time**: игнорирует указанное время и вибрирует предопределенный отрезок времени.
1.72 +
1.73 + navigator.vibrate(3000); // 3000 is ignored
1.74 +
1.75 +#### Окна и Blackberry причуды
1.76 +
1.77 +* **время**: время Макс 5000ms (5с) и минимальное время 1 мс
1.78 +
1.79 + navigator.vibrate(8000); // will be truncated to 5000
1.80 +
1.81 +### Вибрировать с узором (Android и Windows только)
1.82 +
1.83 +Вибрирует на устройства с заданным шаблоном
1.84 +
1.85 + navigator.vibrate(pattern);
1.86 +
1.87 +
1.88 +* **шаблон**: последовательность длительностей (в миллисекундах), для которого требуется включить или выключить вибростол. *(Массив из чисел)*
1.89 +
1.90 +#### Пример
1.91 +
1.92 + // Vibrate for 1 second
1.93 + // Wait for 1 second
1.94 + // Vibrate for 3 seconds
1.95 + // Wait for 1 second
1.96 + // Vibrate for 5 seconds
1.97 + navigator.vibrate([1000, 1000, 3000, 1000, 5000]);
1.98 +
1.99 +
1.100 +### Отмена вибрации (не поддерживается в iOS)
1.101 +
1.102 +Немедленно отменяет любые выполняющиеся вибрации.
1.103 +
1.104 + navigator.vibrate(0)
1.105 +
1.106 +
1.107 +или
1.108 +
1.109 + navigator.vibrate([])
1.110 +
1.111 +
1.112 +или
1.113 +
1.114 + navigator.vibrate([0])
1.115 +
1.116 +
1.117 +Проходя в параметре 0, пустой массив, или массив с одним элементом значения 0 будет отменить любые вибрации.
1.118 +
1.119 +## *Notification.Vibrate (устарело)
1.120 +
1.121 +Устройство вибрирует за определенное количество времени.
1.122 +
1.123 + navigator.notification.vibrate(time)
1.124 +
1.125 +
1.126 +* **time**: Сколько миллисекунд будет вибрировать устройство. *(Число)*
1.127 +
1.128 +### Пример
1.129 +
1.130 + // Vibrate for 2.5 seconds
1.131 + navigator.notification.vibrate(2500);
1.132 +
1.133 +
1.134 +### Особенности iOS
1.135 +
1.136 +* **time**: игнорирует указанное время и вибрирует предопределенный отрезок времени.
1.137 +
1.138 + navigator.notification.vibrate();
1.139 + navigator.notification.vibrate(2500); // 2500 is ignored
1.140 +
1.141 +
1.142 +## *Notification.vibrateWithPattern (устарело)
1.143 +
1.144 +Вибрирует на устройства с заданным шаблоном.
1.145 +
1.146 + navigator.notification.vibrateWithPattern(pattern, repeat)
1.147 +
1.148 +
1.149 +* **шаблон**: последовательность длительностей (в миллисекундах), для которого требуется включить или выключить вибростол. *(Массив из чисел)*
1.150 +* **повторяю**: дополнительный индекс в массиве шаблон для начала повторять (будет повторять пока не отменен), или -1 для не повторения (по умолчанию). *(Число)*
1.151 +
1.152 +### Пример
1.153 +
1.154 + // Immediately start vibrating
1.155 + // vibrate for 100ms,
1.156 + // wait for 100ms,
1.157 + // vibrate for 200ms,
1.158 + // wait for 100ms,
1.159 + // vibrate for 400ms,
1.160 + // wait for 100ms,
1.161 + // vibrate for 800ms,
1.162 + // (do not repeat)
1.163 + navigator.notification.vibrateWithPattern([0, 100, 100, 200, 100, 400, 100, 800]);
1.164 +
1.165 +
1.166 +## *Notification.cancelVibration (устарело)
1.167 +
1.168 +Немедленно отменяет любые выполняющиеся вибрации.
1.169 +
1.170 + navigator.notification.cancelVibration()
1.171 +
1.172 +
1.173 +* Обратите внимание - из-за соответствие спецификации w3c, Избранные методы будут поэтапно
1.174 \ No newline at end of file
