185 lines
4.9 KiB
Markdown
Raw Normal View History

2016-05-16 17:19:54 -06:00
<!---
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
-->
# cordova-plugin-vibration
Dieses Plugin richtet mit dem W3C Vibration Spezifikation http://www.w3.org/TR/vibration/
Dieses Plugin bietet eine Möglichkeit, das Gerät zu vibrieren.
Dieses Plugin definiert globale Objekte einschließlich `navigator.vibrate`.
Obwohl im globalen Gültigkeitsbereich, sind sie nicht bis nach dem `deviceready`-Ereignis.
document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
console.log(navigator.vibrate);
}
## Installation
cordova plugin add cordova-plugin-vibration
## Unterstützte Plattformen
navigator.vibrate,
navigator.notification.vibrate - Amazon Fire OS - Android - BlackBerry 10 - Firefox OS - iOS - Windows Phone 7 and 8
navigator.notification.vibrateWithPattern,
navigator.notification.cancelVibration - Android - Windows Phone 8
## vibrieren (empfohlen)
Diese Funktion hat drei verschiedene Funktionalitäten, die auf der Grundlage von an sie übergebenen Parameter.
### Standard vibrieren
Vibriert das Gerät für einen bestimmten Zeitraum.
navigator.vibrate(time)
oder
navigator.vibrate([time])
-**time**: Millisekunden das Gerät vibriert. *(Anzahl)*
#### Beispiel
// Vibrate for 3 seconds
navigator.vibrate(3000);
// Vibrate for 3 seconds
navigator.vibrate([3000]);
#### iOS Macken
* **Zeit**: ignoriert die angegebene Zeit und für eine voreingestellte Zeit vibriert.
navigator.vibrate(3000); // 3000 is ignored
#### Windows und Blackberry-Kniffe
* **Zeit**: Max. Zeit 5000ms (5 s) und min Zeit ist 1ms
navigator.vibrate(8000); // will be truncated to 5000
### Vibrieren Sie mit einem Muster (Android und Windows nur)
Vibriert das Gerät mit einem vorgegebenen Muster
navigator.vibrate(pattern);
* **Muster**: Folge von Dauer (in Millisekunden) für den ein-oder Ausschalten der Vibrator. *(Array von Zahlen)*
#### Beispiel
// 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]);
#### Windows Phone 8 Macken
* vibrate(Pattern) fällt zurück vibrieren auf mit Standarddauer
### "Abbrechen" Vibration (nicht in iOS unterstützt)
Sofort bricht alle derzeit ausgeführten Schwingungen.
navigator.vibrate(0)
oder
navigator.vibrate([])
oder
navigator.vibrate([0])
Übergabe eines Parameters 0, wird ein leeres Array, oder ein Array mit einem Element der Wert 0 auftretender Schwingungen abbrechen.
## *Notification.Vibrate (veraltet)
Vibriert das Gerät für einen bestimmten Zeitraum.
navigator.notification.vibrate(time)
* **time**: Millisekunden das Gerät vibriert. *(Anzahl)*
### Beispiel
// Vibrate for 2.5 seconds
navigator.notification.vibrate(2500);
### iOS Macken
* **Zeit**: ignoriert die angegebene Zeit und für eine voreingestellte Zeit vibriert.
navigator.notification.vibrate();
navigator.notification.vibrate(2500); // 2500 is ignored
## *Notification.vibrateWithPattern (veraltet)
Vibriert das Gerät mit einem vorgegebenen Muster.
navigator.notification.vibrateWithPattern(pattern, repeat)
* **pattern**: Folge von Dauer (in Millisekunden) für den ein-oder Ausschalten der Vibrator. *(Array von Zahlen)*
* **repeat**: optionale Index in das Array Muster an der wiederholte (wird wiederholt, bis abgebrochen) zu starten, oder-1 für Wiederholung (Standard). *(Anzahl)*
### Beispiel
// 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 (veraltet)
Sofort bricht alle derzeit ausgeführten Schwingungen.
navigator.notification.cancelVibration()
* Note - durch Angleichung an die w3c-Spezifikation, die markierten Methoden abgeschafft werden wird