InputHapticsManager Klasse

Definition

Namespace:

Windows.Devices.Haptics

Stellt Funktionen bereit, um haptisches Feedback auf dem Eingabegerät auszulösen, das zuletzt Eingaben an den zugehörigen Thread übermittelt hat, wenn das Gerät Haptik und Eingabe vor kurzem empfangen hat. Das Objekt muss für denselben Thread verwendet werden, auf dem es erstellt wurde.

public ref class InputHapticsManager sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 1245184)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class InputHapticsManager final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 1245184)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class InputHapticsManager

Public NotInheritable Class InputHapticsManager

Vererbung

Object Platform::Object IInspectable InputHapticsManager

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Anforderungen	Beschreibung
Gerätefamilie	Windows 11, version 24H2 (eingeführt in 10.0.26100.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v19.0)

Beispiele

Das folgende Beispiel zeigt, wie eine haptische Wellenform auf dem Eingabegerät ausgelöst wird, die zuletzt Eingaben an den aktuellen Thread übermittelt hat. Wenn die angeforderte Wellenform nicht unterstützt wird, ermöglicht das Übergeben von 0 für den zweiten Parameter dem System die Verwendung eines gerätespezifischen Fallbacks. Im Beispiel werden auch Fälle behandelt, in denen die API nicht verfügbar oder nicht unterstützt wird.

bool SendHapticFeedback(uint16_t waveform)
{
    auto hapticsManagerStatics = winrt::try_get_activation_factory<
        winrt::InputHapticsManager, winrt::IInputHapticsManagerStatics>();

    if (hapticsManagerStatics && hapticsManagerStatics.IsSupported())
    {
        return hapticsManagerStatics
            .GetForCurrentThread()
            .TrySendHapticWaveform(waveform, 0);
    }

    return false;
}

Eigenschaften

Name	Beschreibung
CurrentHapticsController	Ruft das SimpleHapticsController - Objekt für das Eingabegerät ab, das zuletzt Eingaben an den Thread übermittelt hat (oder der Controller, der von SetOverrideHapticsController festgelegt wird, wenn eine Außerkraftsetzung aktiv ist).
CurrentHapticsControllerDeviceType	Ruft den Typ des haptischen Geräts für das Eingabegerät ab, von dem die Eingabe zuletzt vom Thread empfangen wurde (oder der von SetOverrideHapticsController festgelegte Gerätetyp, wenn eine Außerkraftsetzung aktiv ist).
ThreadId	Ruft die ID des Threads ab, der dieses InputHapticsManager -Objekt besitzt.

Methoden

Name	Beschreibung
ClearOverrideHapticsController(HapticsControllerOverrideToken)	Löscht die SimpleHapticsController-Außerkraftsetzung , die zuvor mit dem angegebenen Token festgelegt wurde.
GetForCurrentThread()	Gibt das InputHapticsManager - Objekt für den aktuellen Thread zurück.
IsHapticDevicePresent()	Gibt an, ob ein Gerät, das Haptik unterstützt, auf dem System vorhanden ist, unabhängig vom Gerät, das zuletzt Eingaben an den aufrufenden Thread übermittelt hat.
IsSupported()	Gibt an, ob die InputHapticsManager-Funktionalität auf dem System unterstützt wird.
SetOverrideHapticsController(HapticDeviceType, SimpleHapticsController)	Legt den SimpleHapticsController und HapticDeviceType fest, den der Manager für seine Methoden und Eigenschaften verwenden soll. Mehrere Außerkraftsetzungen können gleichzeitig aktiv sein, wobei der Vorgesetzte die zuletzt bereitgestellte verwendet.
TryGetForThread(UInt32)	Ruft den InputHapticsManager für den angegebenen Thread ab, sofern vorhanden.
TrySendHapticWaveform(UInt16, UInt16, Double)	Versucht, die angegebene Wellenform mit der angegebenen Intensität auf dem Eingabegerät auszulösen, das zuletzt Eingaben an den Thread übermittelt hat. Die Fallbackwellenform wird verwendet, wenn die erste Wellenform nicht unterstützt wird.
TrySendHapticWaveform(UInt16, UInt16)	Versucht, die angegebene Wellenform auf dem Eingabegerät auszulösen, das zuletzt Eingaben an den Thread übermittelt hat. Die Fallbackwellenform wird verwendet, wenn die erste Wellenform nicht unterstützt wird.
TrySendHapticWaveformForDuration(UInt16, UInt16, Double, TimeSpan)	Versucht, die angegebene Wellenform mit der angegebenen Intensität und Dauer auf dem Eingabegerät auszulösen, das zuletzt Eingaben an den Thread übermittelt hat. Die Fallbackwellenform wird verwendet, wenn die erste Wellenform nicht unterstützt wird.
TrySendHapticWaveformForPlayCount(UInt16, UInt16, Double, Int32, TimeSpan)	Versucht, die angegebene Wellenform mit der angegebenen Intensität, der Wiedergabeanzahl und dem Pausenintervall für die Wiedergabe auf dem Eingabegerät auszulösen, das zuletzt Eingaben an den Thread übermittelt hat. Die Fallbackwellenform wird verwendet, wenn die erste Wellenform nicht unterstützt wird.
TryStopFeedback()	Versucht, eine laufende haptische Wiedergabe auf dem Eingabegerät zu beenden, die zuletzt eine haptische Wellenform vom Vorgesetzten erhalten hat.

Weitere Informationen

• SimpleHapticsController
• HapticDeviceType
• HapticsControllerOverrideToken
• KnownSimpleHapticsControllerWaveforms