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 這個外掛程式將對齊與 W3C 振動規範 HTTP://www.w3.org/TR/vibration/
24 這個外掛程式提供了方法振動設備。
26 ## 安裝
28 cordova plugin add org.apache.cordova.vibration
31 ## 支援的平臺
33 navigator.vibrate
34 navigator.notification.vibrate-亞馬遜火 OS-Android-黑莓 10-火狐瀏覽器作業系統 — — iOS-Windows Phone 7 和 8
36 navigator.notification.vibrateWithPattern,
37 navigator.notification.cancelVibration-安卓系統
39 ## 震動 (推薦)
41 此函數具有三個不同的功能,基於參數傳遞給它。
43 ### 標準振動
45 為給定時間振動設備。
47 navigator.vibrate(time)
50 或
52 navigator.vibrate([time])
55 -**時間**: 毫秒以振動裝置。*(人數)*
57 #### 示例
59 // Vibrate for 3 seconds
60 navigator.vibrate(3000);
62 // Vibrate for 3 seconds
63 navigator.vibrate([3000]);
66 #### iOS 的怪癖
68 * **時間**: 忽略指定的時間和震動的一個預先設定的時間。
70 navigator.vibrate(3000); // 3000 is ignored
72 #### Windows 和黑莓的怪癖
74 * **時間**: 最長時間是 5000ms (5s) 和最小時間為 1ms
76 navigator.vibrate(8000); // will be truncated to 5000
78 ### 以一種模式 (安卓系統和僅限 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 * **時間**: 毫秒以振動裝置。*(人數)*
125 ### 示例
127 // Vibrate for 2.5 seconds
128 navigator.notification.vibrate(2500);
131 ### iOS 的怪癖
133 * **時間**: 忽略指定的時間和震動的一個預先設定的時間。
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 規範,因出演的方法將被淘汰