Curseurs — MRTK2

Slider example

Les curseurs sont des composants d’interface utilisateur qui vous permettent de modifier en permanence une valeur en déplaçant un curseur sur une piste. Actuellement, le curseur de pincement peut être déplacé en saisissant directement le curseur, soit directement, soit à une distance. Les curseurs fonctionnent sur ar et VR, à l’aide de contrôleurs de mouvement, de mains ou de mouvements + voix.

Exemple de scène

Vous trouverez des exemples dans la scène SliderExample sous MRTK/Examples/Demos/UX/Slider/Scenes/.

Comment utiliser des curseurs

Faites glisser et déposez le préfabriqué PinchSlider dans la hiérarchie de scène. Si vous souhaitez modifier ou créer votre propre curseur, n’oubliez pas d’effectuer les opérations suivantes :

  • Assurez-vous que votre objet pouce a un collisionneur dessus. Dans le préfabriqué PinchSlider, le collider est sur SliderThumb/Button_AnimationContainer/Slider_Button
  • Assurez-vous que l’objet contenant le collider a également un composant Near Interaction Grabable sur celui-ci, si vous souhaitez pouvoir saisir le curseur près.

Nous vous recommandons également d’utiliser la hiérarchie suivante

  • PinchSlider - Contient le sliderComponent
    • TouchCollider - Collider contenant la zone sélectionnable entière du curseur. Active le comportement Ancrer à positionner.
    • SliderThumb - Contient le pouce mobile
    • TrackVisuals : contenant la piste et tous les autres visuels
    • OtherVisuals - Contenant d’autres visuels

Événements slider

Les curseurs exposent les événements suivants :

  • OnValueUpdated - Appelé chaque fois que la valeur du curseur change
  • OnInteractionStarted : appelé lorsque l’utilisateur saisit le curseur
  • OnInteractionEnded : appelé lorsque l’utilisateur relâche le curseur
  • OnHoverEntered : appelé lorsque la main/le contrôleur de l’utilisateur pointe sur le curseur, à l’aide d’une interaction proche ou éloignée.
  • OnHoverExited : appelé lorsque la main/le contrôleur de l’utilisateur n’est plus près du curseur.

Configuration du curseur lié et de l’axe

Vous pouvez déplacer directement les points de départ et de fin du curseur en déplaçant les poignées dans la scène :

Sliders Config

Vous pouvez également spécifier l’axe (dans l’espace local) du curseur via le champ Axe du curseur

Si vous ne pouvez pas utiliser les poignées, vous pouvez spécifier à la place les points de début et de fin du curseur via les champs Distance de début et de fin du curseur . Ceux-ci spécifient la position de début/fin du curseur sous la forme d’une distance par rapport au centre du curseur, en coordonnées locales. Cela signifie qu’une fois que vous avez défini les distances de début et de fin du curseur comme vous le souhaitez, vous pouvez mettre à l’échelle le curseur pour qu’il soit plus petit ou plus grand sans avoir à mettre à jour les distances de début et de fin.

Propriétés de l’inspecteur

Racine du pouce Objet de jeu qui contient le curseur.

Ancrer Pour positionner si ce curseur s’aligne ou non sur la position désignée sur le curseur

Est tactile Indique si ce curseur est contrôlable par le biais d’événements tactiles

Collider de pouce Collisionneur qui contrôle le curseur

Collisionneur tactile Zone du curseur qui peut être tactile ou sélectionnée lorsque Ancrer Position est vraie.

Valeur du curseur Valeur du curseur.

Utiliser des divisions d’étape de curseur Détermine si ce curseur est incrémenté en étapes ou en continu.

Divisions d’étape de curseur Nombre de sous-divisions dans laquelle le curseur est divisé lorsque l’option Utiliser les divisions d’étapes du curseur est activée.

Suivre les visuels Objet de jeu qui contient les visuels de piste souhaités qui vont le long du curseur.

Graduations Objet de jeu qui contient les graduations souhaitées qui vont le long du curseur.

Visuels de pouce Objet de jeu qui contient le visuel de pouce souhaité qui va le long du curseur.

Axe du curseur Axe que le curseur se déplace le long.

Distance de début du curseur Où démarre la piste du curseur, à mesure que la distance entre le centre et l’axe des curseurs, dans les unités d’espace locales.

Distance de fin du curseur Où se termine la piste du curseur, à mesure que la distance entre le centre et l’axe des curseurs, dans les unités d’espace local.

Lorsque l’utilisateur met à jour la valeur de l’axe du curseur dans l’éditeur, si les visuels de suivi ou les visuels de graduation sont spécifiés, leur transformation est mise à jour. Plus précisément, leur position locale est réinitialisée et leur rotation locale est définie pour correspondre à l’orientation de l’axe du curseur. Leur échelle n’est pas modifiée. Si les graduations ont un composant Collection d’objets Grid, la disposition et cellWidth ou CellHeight est mise à jour en conséquence pour correspondre à l’axe des curseurs.

Exemples de configurations de curseur

Curseurs continus avec Ancrer à positionnerContinuous Sliders

Curseurs d’étape avec Ancrer à positionner

Step Sliders

Curseurs tactiles

Touch Sliders