XrInputAction QML Type

Représente une action d'un contrôleur d'entrée. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités
• Les membres obsolètes

Propriétés

• actionId : List<enumeration>
• actionName : string
• controller : enumeration (since 6.10)
• enabled : bool (since 6.9)
• pressed : bool
• value : real

Signaux

• triggered()

Description détaillée

Les actions peuvent être booléennes, comme une pression sur un bouton, ou analogiques, comme un axe de joystick.

Utilisez la propriété pressed ou le signal triggered pour réagir à une action booléenne. Une action analogique définira la propriété value.

L'exemple suivant montre comment réagir à une pression sur la poignée de la main droite ou à un geste de pincement de la main droite à partir du suivi de la main :

XrInputAction {
    hand: XrInputAction.RightHand
    actionId: [XrInputAction.SqueezePressed, XrInputAction.SqueezeValue, XrInputAction.IndexFingerPinch]
    onTriggered: console.log("Do action here.")
}

La raison pour laquelle les propriétés SqueezePressed et SqueezeValue sont spécifiées est que certains contrôleurs ont un bouton de poignée analogique et que d'autres n'ont qu'un interrupteur de poignée marche/arrêt.

Documentation sur les propriétés

actionId : List<enumeration>

Spécifie la ou les action(s) à laquelle/auxquelles il faut réagir

Contient une liste d'identifiants qui peuvent avoir les valeurs suivantes :

actionName : string

Le nom de l'action de saisie.

Utilisez cette propriété pour spécifier le nom de l'action d'entrée personnalisée à laquelle vous souhaitez réagir. Cette propriété n'a pas d'effet si l'option actionId est activée.

controller : enumeration [since 6.10]

Le contrôleur auquel cette action d'entrée s'appliquera.

Spécifie le contrôleur auquel réagir.

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

Cette propriété a été introduite dans Qt 6.10.

enabled : bool [default: true, since 6.9]

Cette propriété détermine si l'action d'entrée réagit aux événements.

Cette propriété a été introduite dans Qt 6.9.

pressed : bool

Indique si l'action de saisie est actuellement enfoncée.

Utilisez cette propriété pour vérifier si l'action de saisie (par exemple, un bouton) est actuellement enfoncée.

value : real

La valeur analogique de l'action d'entrée.

Pour les entrées analogiques, telles que la position d'un pouce, cette propriété contient la valeur de l'entrée (généralement dans la plage [0, 1]).

Documentation sur les signaux

triggered()

Ce signal est émis lorsqu'une action booléenne est activée. Cela se produit au moment où la propriété pressed est définie sur true.