VibrationDevice Klasse

Referenz

Definition

Namespace:: Windows.Phone.Devices.Notification

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Vibriert das Telefon.

public ref class VibrationDevice sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Phone.PhoneContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class VibrationDevice final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Phone.PhoneContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class VibrationDevice

Public NotInheritable Class VibrationDevice

Vererbung: Object Platform::Object IInspectable VibrationDevice

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute

Windows-Anforderungen

Gerätefamilie	Windows Mobile Extension SDK (eingeführt in 10.0.10240.0)
API contract	Windows.Phone.PhoneContract (eingeführt in v1.0)

Beispiele

Sie vibrieren das Telefon, indem Sie die Vibrate-Methode der VibrationDevice-Klasse aufrufen.

Importieren Sie den Windows.Phone.Devices.Notification-Namespace .

using Windows.Phone.Devices.Notification;

Rufen Sie einen Verweis auf den Schwingungscontroller ab, indem Sie die statische GetDefault-Methode der VibrationDevice-Klasse aufrufen.

VibrationDevice testVibrationDevice = VibrationDevice.GetDefault();

Starten Sie die Vibration, indem Sie die Vibrate-Methode der VibrationDevice-Klasse aufrufen. Geben Sie die Dauer als TimeSpan-Wert an.

testVibrationDevice.Vibrate(TimeSpan.FromSeconds(3));

Beenden Sie bei Bedarf die Vibration, indem Sie die Cancel-Methode der VibrationDevice-Klasse aufrufen.

testVibrationDevice.Cancel();

Hinweise

Windows Phone Geräte enthalten einen Schwingungscontroller. Ihre App kann das Telefon bis zu 5 Sekunden lang vibrieren, um den Benutzer über ein wichtiges Ereignis zu benachrichtigen.

Verwenden Sie die Vibrationsfunktion in Maßen. Verlassen Sie sich bei kritischen Benachrichtigungen nicht auf das Vibrationsfeature, da der Benutzer Vibrationen deaktivieren kann.

Um eine App zu testen, die den Schwingungscontroller effektiv verwendet, müssen Sie ihn auf einem physischen Gerät testen. Der Emulator kann keine Vibrationen simulieren und liefert keine akustische oder visuelle Rückmeldung, dass Vibrationen auftreten.

Eine App, die im Hintergrund ausgeführt wird, kann das Smartphone nicht vibrieren. Wenn Ihr Code versucht, Vibrationen zu verwenden, während die App im Hintergrund ausgeführt wird, geschieht nichts, aber es wird keine Ausnahme ausgelöst. Wenn Sie das Smartphone vibrieren möchten, während Ihre App im Hintergrund ausgeführt wird, müssen Sie eine Popupbenachrichtigung implementieren.

Methoden

Cancel()	Stoppt die Vibration des Telefons.
GetDefault()	Ruft eine instance der VibrationDevice-Klasse ab.
Vibrate(TimeSpan)	Vibriert das Telefon für die angegebene Dauer (von 0 bis 5 Sekunden).

Gilt für:

Freigeben über