Skip to main content

Pavé tactile

Contrôle analogique qui permet au joueur d’interagir de façon semblable au pavé tactile d’un ordinateur portable.

Propriétés

type - “touchpad” axis - objet ou tableau. Un seul axe ou un tableau d’axes qui décrivent le mappage de ce contrôle de pavé tactile. action - objet, facultatif. Une action à appeler au toucher en plus du mappage d’axe. renderAsButton - booléen, facultatif. La valeur par défaut est false. Définissez cette valeur sur true pour afficher visuellement le pavé tactile comme un bouton. enabled - booléen, facultatif. La valeur par défaut est true. Définit l’état visuel du contrôle comme activé/désactivé. Un contrôle désactivé recevra toujours les entrées du joueur, mais ne modifiera PAS son style visuel en fonction de ces entrées. visible - booléen, facultatif. La valeur par défaut est true. Détermine si le contrôle est affiché au joueur pour qu’il puisse interagir avec celui-ci. Pour le modifier pendant le jeu, consultez Modification des dispositions tactiles à l’aide de l’état du jeu. styles - objet, facultatif. Personnalisation de la représentation visuelle du contrôle. Les styles sont représentés sous forme d’un objet par état pouvant être stylisé. Les états suivants du contrôle peuvent être stylisés :
  • default - Le style de base.
  • disabled - Le style lorsque le contrôle est désactivé. S’il n’est pas spécifié, une transformation est appliquée au style par défaut lorsque le contrôle est désactivé afin qu’il paraisse désactivé.
  • idle - Appliqué lorsque le joueur n’interagit PAS avec le contrôle.
  • moving - Appliqué lorsque le joueur touche le contrôle et qu’aucune action n’est définie.
  • activated - Appliqué lorsque le joueur touche le contrôle et qu’une action est définie.
Propriétés de style par état opacity - nombre, facultatif. L’opacité à appliquer au contrôle. La valeur par défaut est 1.0 pour tous les états, sauf disabled. background - objet, facultatif. Peut être soit une couleur, soit une ressource d’image. faceImage - objet, facultatif. Peut être soit une icône, soit une ressource d’image. Dimensions des ressources Pour chacun des objets de style qui acceptent des ressources d’image, une ressource donnée est fournie à une résolution de base et à des échelles de 1.5x, 2.0x, 3.0x et 4.0x de cette résolution de base. La résolution d’une image donnée doit être inférieure ou égale aux résolutions maximales suivantes :

Remarques

Le touchpad convient le mieux à une sortie non persistante et sans zone morte, généralement la caméra de visée dans un jeu à la première ou à la troisième personne. Pour les jeux qui prennent en charge l’entrée de la souris, le touchpad peut être utilisé avec la souris relative afin d’offrir une expérience de caméra de visée plus précise. Remarques sur le style Lorsque renderAsButton est true :
  • Dans l’état activated, le faceImage est affiché 25 % plus petit.
  • Des étiquettes et un style par défaut pour la couleur d’arrière-plan sont fournis pour les boutons qui n’utilisent pas de ressources personnalisées et qui ont une seule action parmi gamepadX, gamepadY, gamepadA ou gamepadB.

Exemples

Exemple 1 : Pavé tactile avec une icône de visée

Figure 1. Contrôle de pavé tactile Utilisateur interagissant avec un pavé tactile

Exemple 2 : Pavé tactile avec une icône de visée affiché comme un bouton

Figure 1. Contrôle de pavé tactile en forme de bouton Utilisateur interagissant avec un pavé tactile affiché comme un bouton

Configuration requise

Version de la disposition : 1.0+ (style disponible à partir de la version de disposition 3.0+)
Last modified on October 6, 2026