> ## Documentation Index > Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # Panel táctil > Panel táctil # 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](/es/reference/system/touchadaptationkit/types/game-streaming-touch-axis) o una matriz de [ejes](/es/reference/system/touchadaptationkit/types/game-streaming-touch-axis) que describen la asignación de este control de panel táctil. `action` - *object*, *opcional*. Una [acción](/es/reference/system/touchadaptationkit/types/game-streaming-touch-action) 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](/es/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-touch-changing-layouts-game-state.md#change_state). `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](/es/reference/system/touchadaptationkit/types/game-streaming-touch-color) o un [recurso de imagen](/es/reference/system/touchadaptationkit/types/game-streaming-touch-asset). `faceImage` - *object*, *opcional*. Puede ser un [icono](/es/reference/system/touchadaptationkit/types/game-streaming-touch-icon) o un [recurso de imagen](/es/reference/system/touchadaptationkit/types/game-streaming-touch-asset). **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: | Objeto | @1.0x | @1.5x | @2.0x | @3.0x | @4.0x | | :- | :- | :- | :- | :- | :- | | faceImage | 60x60 | 90x90 | 120x120 | 180x180 | 240x240 | | background (renderAsButton = true) | 60x60 | 90x90 | 120x120 | 180x180 | 240x240 | | background (renderAsButton = false) | 120x120 | 90x90 | 240x240 | 360x360 | 480x480 | ## 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](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/reference/game-streaming-touch-control-images-touchpad.gif?s=964c6d216b29d4d0f46f3bf0c9ae96e2) ```JSON theme={null} { "type": "touchpad", "axis": { "input": "axisXY", "output": "rightJoystick", "sensitivity": 3 }, "styles": { "default" : { "faceImage" : { "type": "icon", "value": "look" } } } } ``` #### 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](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/reference/game-streaming-touch-control-images-touchpad-renderAsbutton.gif?s=e803a482b67fdb7ad2eaea7608d4b0c3) ```JSON theme={null} { "type": "touchpad", "renderAsButton": true, "axis": { "input": "axisXY", "output": "rightJoystick", "sensitivity": 3 }, "styles": { "default" : { "faceImage" : { "type": "icon", "value": "look" } } } } ``` ## Requisitos **Versión del diseño:** 1.0+ (estilos disponibles a partir de la versión de diseño 3.0+) ## Related topics - [Referencia del kit de adaptación táctil (TAK)](/es/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-kit-overview.md) - [Touch Adaptation Kit](/es/reference/system/touchadaptationkit/touchadaptationkit-reference.md) - [Diseño de controles táctiles de shooter en primera persona](/es/build/core-features/common/game-streaming/building-touch-layouts/samples/game-streaming-touch-tak-sample-first-person.md) - [Guía del diseñador para crear controles táctiles](/es/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-designers-guide.md) - [Plantillas](/es/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-templates.md)