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 Dieses Plugin richtet mit dem W3C Vibration Spezifikation http://www.w3.org/TR/vibration/
24 Dieses Plugin bietet eine Möglichkeit, das Gerät zu vibrieren.
26 ## Installation
28 cordova plugin add org.apache.cordova.vibration
31 ## Unterstützte Plattformen
33 Navigator.Vibrate
34 Navigator.Notification.Vibrate - Amazon Fire OS - Android - BlackBerry 10 - Firefox OS - iOS - Windows Phone 7 und 8
36 navigator.notification.vibrateWithPattern,
37 navigator.notification.cancelVibration - Android
39 ## vibrieren (empfohlen)
41 Diese Funktion hat drei verschiedene Funktionalitäten, die auf der Grundlage von an sie übergebenen Parameter.
43 ### Standard vibrieren
45 Vibriert das Gerät für einen bestimmten Zeitraum.
47 navigator.vibrate(time)
50 oder
52 navigator.vibrate([time])
55 -**Zeit**: Millisekunden das Gerät vibriert. *(Anzahl)*
57 #### Beispiel
59 // Vibrate for 3 seconds
60 navigator.vibrate(3000);
62 // Vibrate for 3 seconds
63 navigator.vibrate([3000]);
66 #### iOS Macken
68 * **Zeit**: ignoriert die angegebene Zeit und für eine voreingestellte Zeit vibriert.
70 navigator.vibrate(3000); // 3000 is ignored
72 #### Windows und Blackberry-Kniffe
74 * **Zeit**: Max. Zeit 5000ms (5 s) und min Zeit ist 1ms
76 navigator.vibrate(8000); // will be truncated to 5000
78 ### Vibrieren Sie mit einem Muster (Android und Windows nur)
80 Vibriert das Gerät mit einem vorgegebenen Muster
82 navigator.vibrate(pattern);
85 * **Muster**: Folge von Dauer (in Millisekunden) für den ein-oder Ausschalten der Vibrator. *(Array von Zahlen)*
87 #### Beispiel
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 ### "Abbrechen" Vibration (nicht in iOS unterstützt)
99 Sofort bricht alle derzeit ausgeführten Schwingungen.
101 navigator.vibrate(0)
104 oder
106 navigator.vibrate([])
109 oder
111 navigator.vibrate([0])
114 Übergabe eines Parameters 0, wird ein leeres Array, oder ein Array mit einem Element der Wert 0 auftretender Schwingungen abbrechen.
116 ## *Notification.Vibrate (veraltet)
118 Vibriert das Gerät für einen bestimmten Zeitraum.
120 navigator.notification.vibrate(time)
123 * **Zeit**: Millisekunden das Gerät vibriert. *(Anzahl)*
125 ### Beispiel
127 // Vibrate for 2.5 seconds
128 navigator.notification.vibrate(2500);
131 ### iOS Macken
133 * **Zeit**: ignoriert die angegebene Zeit und für eine voreingestellte Zeit vibriert.
135 navigator.notification.vibrate();
136 navigator.notification.vibrate(2500); // 2500 is ignored
139 ## *Notification.vibrateWithPattern (veraltet)
141 Vibriert das Gerät mit einem vorgegebenen Muster.
143 navigator.notification.vibrateWithPattern(pattern, repeat)
146 * **Muster**: Folge von Dauer (in Millisekunden) für den ein-oder Ausschalten der Vibrator. *(Array von Zahlen)*
147 * **Wiederholen**: optionale Index in das Array Muster an der wiederholte (wird wiederholt, bis abgebrochen) zu starten, oder-1 für Wiederholung (Standard). *(Anzahl)*
149 ### Beispiel
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 (veraltet)
165 Sofort bricht alle derzeit ausgeführten Schwingungen.
167 navigator.notification.cancelVibration()
170 * Note - durch Angleichung an die w3c-Spezifikation, die markierten Methoden abgeschafft werden wird