diff -r 000000000000 -r e8ccd40d0ef6 Touchgui/plugins/org.apache.cordova.vibration/doc/zh/index.md --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Touchgui/plugins/org.apache.cordova.vibration/doc/zh/index.md Thu Jun 04 14:50:33 2015 +0200 @@ -0,0 +1,170 @@ + + +# org.apache.cordova.vibration + +這個外掛程式將對齊與 W3C 振動規範 HTTP://www.w3.org/TR/vibration/ + +這個外掛程式提供了方法振動設備。 + +## 安裝 + + cordova plugin add org.apache.cordova.vibration + + +## 支援的平臺 + +navigator.vibrate +navigator.notification.vibrate-亞馬遜火 OS-Android-黑莓 10-火狐瀏覽器作業系統 — — iOS-Windows Phone 7 和 8 + +navigator.notification.vibrateWithPattern, +navigator.notification.cancelVibration-安卓系統 + +## 震動 (推薦) + +此函數具有三個不同的功能,基於參數傳遞給它。 + +### 標準振動 + +為給定時間振動設備。 + + navigator.vibrate(time) + + +或 + + navigator.vibrate([time]) + + +-**時間**: 毫秒以振動裝置。*(人數)* + +#### 示例 + + // Vibrate for 3 seconds + navigator.vibrate(3000); + + // Vibrate for 3 seconds + navigator.vibrate([3000]); + + +#### iOS 的怪癖 + +* **時間**: 忽略指定的時間和震動的一個預先設定的時間。 + + navigator.vibrate(3000); // 3000 is ignored + +#### Windows 和黑莓的怪癖 + +* **時間**: 最長時間是 5000ms (5s) 和最小時間為 1ms + + navigator.vibrate(8000); // will be truncated to 5000 + +### 以一種模式 (安卓系統和僅限 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) + + +* **時間**: 毫秒以振動裝置。*(人數)* + +### 示例 + + // Vibrate for 2.5 seconds + navigator.notification.vibrate(2500); + + +### iOS 的怪癖 + +* **時間**: 忽略指定的時間和震動的一個預先設定的時間。 + + 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