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 Этот плагин выравнивает с http://www.w3.org/TR/vibration/ спецификации W3C вибрации
24 Этот плагин позволяет вибрировать устройство.
26 ## Установка
28 cordova plugin add org.apache.cordova.vibration
31 ## Поддерживаемые платформы
33 Navigator.Vibrate
34 Navigator.Notification.Vibrate - Amazon Fire OS - Android - BlackBerry 10 - Firefox OS - iOS - Windows Phone 7 и 8
36 navigator.notification.vibrateWithPattern,
37 navigator.notification.cancelVibration - Android
39 ## вибрировать (рекомендуется)
41 Эта функция имеет три различных функций, на основе параметров, передаваемых ему.
43 ### Стандарт вибрировать
45 Устройство вибрирует за определенное количество времени.
47 navigator.vibrate(time)
50 или
52 navigator.vibrate([time])
55 -**time**: Сколько миллисекунд будет вибрировать устройство. *(Число)*
57 #### Пример
59 // Vibrate for 3 seconds
60 navigator.vibrate(3000);
62 // Vibrate for 3 seconds
63 navigator.vibrate([3000]);
66 #### Особенности iOS
68 * **time**: игнорирует указанное время и вибрирует предопределенный отрезок времени.
70 navigator.vibrate(3000); // 3000 is ignored
72 #### Окна и Blackberry причуды
74 * **время**: время Макс 5000ms (5с) и минимальное время 1 мс
76 navigator.vibrate(8000); // will be truncated to 5000
78 ### Вибрировать с узором (Android и Windows только)
80 Вибрирует на устройства с заданным шаблоном
82 navigator.vibrate(pattern);
85 * **шаблон**: последовательность длительностей (в миллисекундах), для которого требуется включить или выключить вибростол. *(Массив из чисел)*
87 #### Пример
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 ### Отмена вибрации (не поддерживается в iOS)
99 Немедленно отменяет любые выполняющиеся вибрации.
101 navigator.vibrate(0)
104 или
106 navigator.vibrate([])
109 или
111 navigator.vibrate([0])
114 Проходя в параметре 0, пустой массив, или массив с одним элементом значения 0 будет отменить любые вибрации.
116 ## *Notification.Vibrate (устарело)
118 Устройство вибрирует за определенное количество времени.
120 navigator.notification.vibrate(time)
123 * **time**: Сколько миллисекунд будет вибрировать устройство. *(Число)*
125 ### Пример
127 // Vibrate for 2.5 seconds
128 navigator.notification.vibrate(2500);
131 ### Особенности iOS
133 * **time**: игнорирует указанное время и вибрирует предопределенный отрезок времени.
135 navigator.notification.vibrate();
136 navigator.notification.vibrate(2500); // 2500 is ignored
139 ## *Notification.vibrateWithPattern (устарело)
141 Вибрирует на устройства с заданным шаблоном.
143 navigator.notification.vibrateWithPattern(pattern, repeat)
146 * **шаблон**: последовательность длительностей (в миллисекундах), для которого требуется включить или выключить вибростол. *(Массив из чисел)*
147 * **повторяю**: дополнительный индекс в массиве шаблон для начала повторять (будет повторять пока не отменен), или -1 для не повторения (по умолчанию). *(Число)*
149 ### Пример
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 (устарело)
165 Немедленно отменяет любые выполняющиеся вибрации.
167 navigator.notification.cancelVibration()
170 * Обратите внимание - из-за соответствие спецификации w3c, Избранные методы будут поэтапно