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

Thu, 04 Jun 2015 14:50:33 +0200

author
Michael Schloh von Bennewitz <michael@schloh.com>
date
Thu, 04 Jun 2015 14:50:33 +0200
changeset 0
e8ccd40d0ef6
permissions
-rw-r--r--

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 規範,因出演的方法將被淘汰

mercurial