Skip to main content

​
Panel táctil

Control analógico que permite al jugador interactuar de forma similar al panel táctil de un portátil.

​
Propiedades

type - “touchpad” axis - object o array. Un único eje o una matriz de ejes que describen la asignación de este control de panel táctil. action - object, opcional. Una acción que se invoca al tocar, además de la asignación de ejes. renderAsButton - boolean, opcional. El valor predeterminado es false. Establézcalo en true para representar visualmente el panel táctil como un botón. enabled - boolean, opcional. El valor predeterminado es true. Establece el estado visual del control como habilitado o deshabilitado. Un control deshabilitado seguirá recibiendo la entrada del jugador, pero NO cambiará el estilo visual en función de la entrada. visible - boolean, opcional. El valor predeterminado es true. Determina si el control se muestra al jugador para que interactúe con él. Para cambiarlo durante el juego, consulte Cambio de diseños táctiles mediante el estado del juego. styles - object, opcional. Personalización de la representación visual del control. Los estilos se representan como un objeto por cada estado al que se pueden aplicar estilos. El control de botón puede tener estilos aplicados a los siguientes estados:
  • default - El estilo base.
  • disabled - El estilo cuando el control está deshabilitado. Si no se especifica, cuando el control esté deshabilitado, se aplicará una transformación al estilo predeterminado para que parezca deshabilitado.
  • idle - Se aplica cuando el jugador NO está interactuando con el control.
  • moving - Se aplica cuando el jugador está tocando el control y no hay ninguna action definida.
  • activated - Se aplica cuando el jugador está tocando el control y hay una action definida.
Propiedades de estilo por estado opacity - number, opcional. La opacidad que se aplica al control. El valor predeterminado es 1.0 para todos los estados excepto disabled. background - object, opcional. Puede ser un color o un recurso de imagen. faceImage - object, opcional. Puede ser un icono o un recurso de imagen. Dimensiones de los recursos Para cada uno de los objetos de estilo que aceptan recursos de imagen, un recurso determinado se proporciona en una resolución base y en escalas de 1.5x, 2.0x, 3.0x y 4.0x de esa resolución base. La resolución de una imagen determinada debe ser menor o igual que las siguientes resoluciones máximas:

​
Comentarios

El touchpad es más adecuado para salidas sin fijación y sin zona muerta, normalmente la cámara de vista en un juego con perspectiva en primera o tercera persona. En los juegos que admiten entrada de mouse, el touchpad se puede usar con el mouse relativo para proporcionar una experiencia de cámara de vista más ajustada. Comentarios sobre estilos Cuando renderAsButton es true:
  • Cuando está en el estado activated, la faceImage se muestra un 25 % más pequeña.
  • Hay etiquetas y estilos predeterminados para el color de fondo de los botones que no usan recursos personalizados y tienen una sola acción de gamepadX, gamepadY, gamepadA o gamepadB.

​
Ejemplos

​
Ejemplo 1: Panel táctil con un icono de mirar

Figura 1. Control de panel táctil Usuario interactuando con un panel táctil

​
Ejemplo 2: Panel táctil con un icono de mirar que se representa como un botón

Figura 1. Control de panel táctil como botón Usuario interactuando con un panel táctil como botón

​
Requisitos

Versión del diseño: 1.0+ (estilos disponibles a partir de la versión de diseño 3.0+)
Last modified on October 19, 2026