Touchgui/plugins/org.apache.cordova.vibration/doc/ru/index.md

changeset 0
e8ccd40d0ef6
equal deleted inserted replaced
-1:000000000000 0:71be37e4e277
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
9
10 http://www.apache.org/licenses/LICENSE-2.0
11
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 -->
19
20 # org.apache.cordova.vibration
21
22 Этот плагин выравнивает с http://www.w3.org/TR/vibration/ спецификации W3C вибрации
23
24 Этот плагин позволяет вибрировать устройство.
25
26 ## Установка
27
28 cordova plugin add org.apache.cordova.vibration
29
30
31 ## Поддерживаемые платформы
32
33 Navigator.Vibrate
34 Navigator.Notification.Vibrate - Amazon Fire OS - Android - BlackBerry 10 - Firefox OS - iOS - Windows Phone 7 и 8
35
36 navigator.notification.vibrateWithPattern,
37 navigator.notification.cancelVibration - Android
38
39 ## вибрировать (рекомендуется)
40
41 Эта функция имеет три различных функций, на основе параметров, передаваемых ему.
42
43 ### Стандарт вибрировать
44
45 Устройство вибрирует за определенное количество времени.
46
47 navigator.vibrate(time)
48
49
50 или
51
52 navigator.vibrate([time])
53
54
55 -**time**: Сколько миллисекунд будет вибрировать устройство. *(Число)*
56
57 #### Пример
58
59 // Vibrate for 3 seconds
60 navigator.vibrate(3000);
61
62 // Vibrate for 3 seconds
63 navigator.vibrate([3000]);
64
65
66 #### Особенности iOS
67
68 * **time**: игнорирует указанное время и вибрирует предопределенный отрезок времени.
69
70 navigator.vibrate(3000); // 3000 is ignored
71
72 #### Окна и Blackberry причуды
73
74 * **время**: время Макс 5000ms (5с) и минимальное время 1 мс
75
76 navigator.vibrate(8000); // will be truncated to 5000
77
78 ### Вибрировать с узором (Android и Windows только)
79
80 Вибрирует на устройства с заданным шаблоном
81
82 navigator.vibrate(pattern);
83
84
85 * **шаблон**: последовательность длительностей (в миллисекундах), для которого требуется включить или выключить вибростол. *(Массив из чисел)*
86
87 #### Пример
88
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]);
95
96
97 ### Отмена вибрации (не поддерживается в iOS)
98
99 Немедленно отменяет любые выполняющиеся вибрации.
100
101 navigator.vibrate(0)
102
103
104 или
105
106 navigator.vibrate([])
107
108
109 или
110
111 navigator.vibrate([0])
112
113
114 Проходя в параметре 0, пустой массив, или массив с одним элементом значения 0 будет отменить любые вибрации.
115
116 ## *Notification.Vibrate (устарело)
117
118 Устройство вибрирует за определенное количество времени.
119
120 navigator.notification.vibrate(time)
121
122
123 * **time**: Сколько миллисекунд будет вибрировать устройство. *(Число)*
124
125 ### Пример
126
127 // Vibrate for 2.5 seconds
128 navigator.notification.vibrate(2500);
129
130
131 ### Особенности iOS
132
133 * **time**: игнорирует указанное время и вибрирует предопределенный отрезок времени.
134
135 navigator.notification.vibrate();
136 navigator.notification.vibrate(2500); // 2500 is ignored
137
138
139 ## *Notification.vibrateWithPattern (устарело)
140
141 Вибрирует на устройства с заданным шаблоном.
142
143 navigator.notification.vibrateWithPattern(pattern, repeat)
144
145
146 * **шаблон**: последовательность длительностей (в миллисекундах), для которого требуется включить или выключить вибростол. *(Массив из чисел)*
147 * **повторяю**: дополнительный индекс в массиве шаблон для начала повторять (будет повторять пока не отменен), или -1 для не повторения (по умолчанию). *(Число)*
148
149 ### Пример
150
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]);
161
162
163 ## *Notification.cancelVibration (устарело)
164
165 Немедленно отменяет любые выполняющиеся вибрации.
166
167 navigator.notification.cancelVibration()
168
169
170 * Обратите внимание - из-за соответствие спецификации w3c, Избранные методы будут поэтапно

mercurial