InputHapticsManager Classe

Définition

Espace de noms:: Windows.Devices.Haptics

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Fournit des fonctionnalités permettant de déclencher des commentaires haptiques sur l’appareil d’entrée qui a récemment remis une entrée au thread associé, si l’appareil prend en charge les haptics et l’entrée a été reçu récemment. L’objet doit être utilisé sur le même thread sur lequel il a été créé.

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(Windows.Foundation.UniversalApiContract, 1245184)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Experimental]
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

[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)]
[Windows.Foundation.Metadata.Experimental]
public sealed class InputHapticsManager

Public NotInheritable Class InputHapticsManager

Héritage: Object Platform::Object IInspectable InputHapticsManager

Attributs: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ExperimentalAttribute

Configuration requise pour Windows

Configuration requise	Description
Famille d’appareils	Windows 11, version 24H2 (introduit dans 10.0.26100.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v19.0)

Exemples

L’exemple suivant montre comment déclencher une forme d’onde haptique sur l’appareil d’entrée qui a récemment remis l’entrée au thread actuel. Si la forme d’onde demandée n’est pas prise en charge, le passage de 0 pour le deuxième paramètre permet au système d’utiliser un secours spécifique au type d’appareil. L’exemple gère également les cas où l’API n’est pas disponible ou n’est pas prise en charge.

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;
}

Propriétés

Nom	Description
CurrentDeviceType	Fournit des fonctionnalités permettant de déclencher des commentaires haptiques sur l’appareil d’entrée qui a récemment remis une entrée au thread associé, si l’appareil prend en charge les haptics et l’entrée a été reçu récemment. L’objet doit être utilisé sur le même thread sur lequel il a été créé.
CurrentHapticsController	Obtient l’objet SimpleHapticsController pour l’appareil d’entrée qui a récemment remis l’entrée au thread (ou le contrôleur défini par SetOverrideHapticsController si une substitution est active).
CurrentHapticsControllerDeviceType	Obtient le type d’appareil haptique pour l’appareil d’entrée à partir duquel l’entrée a été reçue récemment par le thread (ou le type d’appareil défini par SetOverrideHapticsController si une substitution est active).
ThreadId	Obtient l’ID du thread qui possède cet objet InputHapticsManager .

Méthodes

Nom	Description
ClearOverrideHapticsController(HapticsControllerOverrideToken)	Efface le remplacement SimpleHapticsController qui a été précédemment défini avec le jeton spécifié.
GetForCurrentThread()	Retourne l’objet InputHapticsManager pour le thread actuel.
IsHapticDevicePresent()	Indique si un appareil prenant en charge les haptics est présent sur le système, quel que soit l’appareil qui a récemment remis l’entrée au thread appelant.
IsSupported()	Indique si la fonctionnalité InputHapticsManager est prise en charge sur le système.
SetOverrideHapticsController(HapticDeviceType, SimpleHapticsController)	Définit SimpleHapticsController et HapticDeviceType que le gestionnaire doit utiliser pour ses méthodes et ses propriétés. Plusieurs remplacements peuvent être actifs simultanément, avec le responsable à l’aide de celui fourni le plus récemment.
TryGetForThread(UInt32)	Récupère le InputHapticsManager pour le thread spécifié, s’il en existe un.
TrySendHapticWaveform(UInt16, UInt16, Double)	Tente de déclencher la forme d’onde spécifiée, avec l’intensité spécifiée, sur l’appareil d’entrée qui a récemment remis l’entrée au thread. La forme d’onde de secours est utilisée si la première forme d’onde n’est pas prise en charge.
TrySendHapticWaveform(UInt16, UInt16)	Tente de déclencher la forme d’onde spécifiée sur l’appareil d’entrée qui a récemment remis l’entrée au thread. La forme d’onde de secours est utilisée si la première forme d’onde n’est pas prise en charge.
TrySendHapticWaveformForDuration(UInt16, UInt16, Double, TimeSpan)	Tente de déclencher la forme d’onde spécifiée, avec l’intensité et la durée spécifiées, sur l’appareil d’entrée qui a récemment remis l’entrée au thread. La forme d’onde de secours est utilisée si la première forme d’onde n’est pas prise en charge.
TrySendHapticWaveformForPlayCount(UInt16, UInt16, Double, Int32, TimeSpan)	Tente de déclencher la forme d’onde spécifiée, avec l’intensité, le nombre de lecture et l’intervalle de pause de relecture spécifiés, sur l’appareil d’entrée qui a récemment remis l’entrée au thread. La forme d’onde de secours est utilisée si la première forme d’onde n’est pas prise en charge.
TryStopFeedback()	Tente d’arrêter toute lecture haptique en cours sur l’appareil d’entrée qui a reçu récemment une forme d’onde haptique du responsable.

S’applique à

Voir aussi

Commentaires

Cette page a-t-elle été utile ?