> ## 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.

# Acelerador

> Acelerador

# Acelerador

Una versión especializada de un joystick de solo eje Y. Diseñado para juegos de conducción.

## Propiedades

`type` - "throttle"

`axisUp` - *string*. El gatillo al que se asigna la parte superior del control. Debe ser `"leftTrigger"` o `"rightTrigger"`.

`axisDown` - *string*. El gatillo al que se asigna la parte inferior del control. Debe ser `"leftTrigger"` o `"rightTrigger"`.

`relative` - *boolean*, *opcional*. Controla cómo calcula su valor el acelerador. Si es `true`, el valor se basará en la ubicación del toque inicial del usuario. Si es `false`, el valor se basará en el punto central del control. El valor predeterminado es `true`.

`sticky` - *boolean*, *opcional*. Controla lo que ocurre cuando el usuario deja de tocar el control. Si es `true`, el acelerador se mantendrá en el último valor. Si es `false`, se restablecerá a 0. El valor predeterminado es `false`.

`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 acelerador puede tener estilos aplicados a los siguientes estados.

* `default` - El estilo base.
* `activated` - Se aplica cuando el jugador está tocando la perilla y esta se encuentra exactamente en el valor 0 del eje.
* `activatedDown` - Se aplica cuando el jugador está tocando la perilla y la ha movido de forma que se encuentra en la sección negativa (inferior) del eje del acelerador.
* `activatedUp` - Se aplica cuando el jugador está tocando la perilla y la ha movido de forma que se encuentra en la sección positiva (superior) del eje del acelerador.
* `idle` - Se aplica cuando el jugador *no* está interactuando con el control y la perilla tampoco está fija (`sticky`) en la sección superior del eje.
* `idleUp` - Se aplica cuando el jugador *no* está interactuando con el control, la perilla se ha movido a la sección superior y `sticky` se ha establecido en `true`.

**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`.

[`axisUp`](/es/reference/system/touchadaptationkit/types/game-streaming-touch-throttle-axis) - *object*, *opcional*. Un objeto [`axis`](/es/reference/system/touchadaptationkit/types/game-streaming-touch-throttle-axis) que especifica los estilos de la parte positiva (superior) del acelerador.

[`axisDown`](/es/reference/system/touchadaptationkit/types/game-streaming-touch-throttle-axis) - *object*, *opcional*. Un objeto [`axis`](/es/reference/system/touchadaptationkit/types/game-streaming-touch-throttle-axis) que especifica los estilos de la parte negativa (inferior) del acelerador.

[`knob`](/es/reference/system/touchadaptationkit/types/game-streaming-touch-knob) - *object*, *opcional*. El objeto [`knob`](/es/reference/system/touchadaptationkit/types/game-streaming-touch-knob) que especifica los estilos de la parte de la perilla del acelerador.

`indicator` - *object*, *opcional*. Un [trazo](/es/reference/system/touchadaptationkit/types/game-streaming-touch-stroke) que especifica los estilos que se aplican al componente que conecta la perilla con la posición actual en el eje.

**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 |
| :- | :- | :- | :- | :- | :- |
| knob.faceImage | 60x60 | 90x90 | 120x120 | 180x180 | 240x240 |
| knob.background | 60x60 | 90x90 | 120x120 | 180x180 | 240x240 |

## Comentarios

El control `throttle` permite al jugador proporcionar la presión variable de un gatillo mediante un control táctil.

El control `throttle` está diseñado para colocarse en el punto central de la rueda, y para ser el único control entre ese punto y el lateral de la pantalla.

Establezca `sticky` en true si es probable que el jugador quiera aplicar una presión constante al gatillo, lo que le permite establecer el valor y luego usar los dedos para otras acciones.

**Comentarios sobre estilos**

> [!WARNING]
>
> Al transmitir mediante la versión de Windows de Content Test Application, no todos los estilos se mostrarán correctamente.

## Ejemplo

#### Ejemplo 1: Acelerador básico

**Figura 1. Control de acelerador**

![Usuario interactuando con un acelerador](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/reference/game-streaming-touch-control-images-throttle.gif?s=effd39103fb6dd47dbe5275bdfc07426)

Este usa los estilos predeterminados.

```JSON theme={null}
{
    "type": "throttle",
    "axisUp": "rightTrigger",
    "axisDown": "leftTrigger",
    "sticky": true
}
```

#### Ejemplo 2: Acelerador con contorno con estilo e iconos definidos explícitamente

**Figura 1. Control de acelerador personalizado**

![Usuario interactuando con un acelerador personalizado](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/reference/game-streaming-touch-control-images-throttle-customized.gif?s=bfccc19c022aed00a4e3e14833ab2202)

```JSON theme={null}
{
    "type": "throttle",
    "axisUp": "rightTrigger",
    "axisDown": "leftTrigger",
    "sticky": true,
    "styles": {
        "default": {
            "knob" : {
                "faceImage" : {
                    "type": "icon",
                    "value": "gasPedal"
                }
            },
            "axisUp": {
                "stroke" : {
                    "type": "solid",
                    "color":  "#107C10"
                },
                "cap" : {
                    "type": "color",
                    "value": "#107C10"
                }
            },
            "axisDown": {
                "stroke" : {
                    "type": "solid",
                    "color":  "#ff0000"
                },
                "cap" : {
                    "type": "color",
                    "value": "#ff0000"
                }
            }
        },
        "idleUp" : {
            "knob" : {
                "stroke" : {
                    "type": "solid",
                    "color":  "#107C10"
                }
            },
            "indicator" : {
                "type": "solid",
                "color":  "#107C10"
            }
        },
        "activatedUp" : {
            "indicator" : {
                "type": "solid",
                "color":  "#107C10"
            }
        },
        "activatedDown": {
            "knob" : {
                "faceImage" : {
                    "type": "icon",
                    "value": "brakePedal"
                }
            },
            "indicator" : {
                "type": "solid",
                "color":  "#ff0000"
            }
        }
    }
}
```

## Requisitos

**Versión del diseño:** 1.0+ (estilos disponibles a partir de la versión de diseño 3.2+)


## Related topics

- [Touch Adaptation Kit](/pt-BR/reference/system/touchadaptationkit/touchadaptationkit-reference.md)
- [Modelos](/pt-BR/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-templates.md)
- [Plantillas](/es/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-templates.md)
- [Referência do Touch Adaptation Kit (TAK)](/pt-BR/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-kit-overview.md)
- [Referencia del kit de adaptación táctil (TAK)](/es/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-kit-overview.md)
