Sur cette page

XrHapticFeedback QML Type

Gère le retour haptique d'une manette XR. En savoir plus...

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

QtObject

Status: Technology preview

Ce type est en préversion technologique et est susceptible d'évoluer.

Propriétés

Méthodes

Description détaillée

Le retour haptique consiste généralement à appliquer une brève vibration à une manette afin de procurer une sensation 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 la manette 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]

Condition de déclenchement de ce retour haptique.

Cette propriété spécifie comment la propriété « trigger » est interprétée

Elle peut prendre l’une des valeurs suivantes :

ConstanteDescription
XrHapticFeedback.RisingEdgeL'effet haptique démarre lorsque la valeur de « trigger » passe de « false » à « true ».
XrHapticFeedback.TrailingEdgeL'effet haptique démarre lorsque la propriété « trigger » passe de « true » à « false ».

controller : enumeration

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

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 qui déclenche l'effet haptique. La propriété « condition » détermine comment ce déclencheur est interprété.

Voir également start et condition.

Documentation des méthodes

void start()

Lance l'effet de retour haptique.

void stop()

Désactive 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.