En esta página

XrHapticFeedback QML Type

Controla la retroalimentación háptica de un mando XR. Más información...

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

QtObject

Status: Technology preview

Este tipo se encuentra en fase de vista previa tecnológica y está sujeto a cambios.

Propiedades

Métodos

Descripción detallada

La retroalimentación háptica suele consistir en aplicar una breve vibración a un mando para proporcionar una experiencia táctil cuando se produce un evento. Esto puede dar la sensación de estar pulsando un botón, por ejemplo.

Hay dos formas de utilizar XrHapticFeedback:

  • De forma imperativa, llamando a la función ` start `
  • De forma declarativa, especificando trigger y condition

El siguiente código hace que el mando de la derecha vibre cuando el valor de la propiedad ` someObject.hit ` cambia de ` false ` a ` true`:

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

Documentación de la propiedad

condition : enumeration [default: XrHapticFeedback.RisingEdge]

La condición para activar esta retroalimentación háptica.

Esta propiedad especifica cómo se interpreta la propiedad « trigger »

Puede ser una de las siguientes:

ConstanteDescripción
XrHapticFeedback.RisingEdgeEl efecto háptico se inicia cuando trigger cambia de « false » a « true ».
XrHapticFeedback.TrailingEdgeEl efecto háptico comienza cuando trigger cambia de true a false.

controller : enumeration

El controlador al que se aplicará esta retroalimentación háptica.

Puede ser uno de los siguientes:

ConstanteValor
XrHapticFeedback.LeftController
XrHapticFeedback.RightController
XrHapticFeedback.UnknownController

hapticEffect : XrHapticEffect

Esta propiedad describe el efecto que se aplica al controlador cuando se activa la retroalimentación háptica.

trigger : bool

Desencadenante de la retroalimentación háptica

Esta propiedad define a qué reaccionará el efecto háptico. La propiedad condition determina cómo se interpreta el activador.

Véase también start y condition.

Documentación del método

void start()

Activa el efecto de retroalimentación háptica.

void stop()

Desactiva el efecto de retroalimentación háptica.

© 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.