Sur cette page

XrHapticFeedback QML Type

Contrôle le retour haptique pour un contrôleur XR. Plus d'informations...

Import Statement: import QtQuick3D.Xr
Since: Qt 6.9
Inherits:

QtObject

Propriétés

Méthodes

Description détaillée

Le retour haptique consiste généralement à appliquer une courte vibration à un contrôleur afin de fournir une expérience tactile lorsqu'un événement se produit. Cela peut donner l'illusion de toucher un bouton, par exemple.

Il existe deux façons d'utiliser XrHapticFeedback :

  • de manière impérative, en appelant la fonction start
  • De manière déclarative, en spécifiant trigger et condition

Le code suivant fait vibrer le contrôleur de droite lorsque la valeur de la propriété someObject.hit passe de false à true:

XrHapticFeedback {
    controller: XrHapticFeedback.RightController
    condition: XrHapticFeedback.RisingEdge
    trigger: someObject.hit
    hapticEffect: XrSimpleHapticEffect {
        amplitude: 0.5
        duration: 300
        frequency: 3000
    }
}

Documentation sur les propriétés

condition : enumeration [default: XrHapticFeedback.RisingEdge]

La condition de déclenchement de ce retour haptique.

Cette propriété précise comment la propriété trigger est interprétée

Elle peut être l'une des suivantes

ConstanteDescription
XrHapticFeedback.RisingEdgeL'effet haptique commence lorsque trigger passe de false à true.
XrHapticFeedback.TrailingEdgeL'effet haptique commence lorsque trigger passe de true à false.

controller : enumeration

Le contrôleur auquel s'applique ce retour haptique.

Il peut s'agir de l'un des éléments suivants

ConstanteValeur
XrHapticFeedback.LeftController
XrHapticFeedback.RightController
XrHapticFeedback.UnknownController

hapticEffect : XrHapticEffect

Cette propriété décrit l'effet appliqué au contrôleur lorsque le retour haptique est déclenché.

trigger : bool

Déclencheur du retour haptique

Cette propriété définit ce à quoi l'effet haptique réagit. La propriété condition détermine comment le déclencheur est interprété.

Voir également start et condition.

Documentation de la méthode

void start()

Démarre l'effet de retour haptique.

void stop()

Arrête l'effet de retour haptique.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.