> ## 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 Uma versão especializada de um joystick somente do eixo Y. Projetado para jogos de corrida. ## Propriedades `type` - "throttle" `axisUp` - *string*. O gatilho para o qual a parte superior do controle é mapeada. Deve ser `"leftTrigger"` ou `"rightTrigger"`. `axisDown` - *string*. O gatilho para o qual a parte inferior do controle é mapeada. Deve ser `"leftTrigger"` ou `"rightTrigger"`. `relative` - *boolean*, *opcional*. Controla como o acelerador calcula seu valor. Se `true`, o valor será baseado no local do toque inicial do usuário. Se `false`, o valor será baseado no ponto central do controle. O padrão é `true`. `sticky` - *boolean*, *opcional*. Controla o que acontece quando o usuário para de tocar no controle. Se `true`, o acelerador permanecerá no último valor. Se `false`, ele será redefinido para 0. O padrão é `false`. `enabled` - *boolean*, *opcional*. O padrão é `true`. Define o estado visual do controle como habilitado/desabilitado. Um controle desabilitado ainda receberá entrada do jogador, mas *não* alterará o estilo visual com base na entrada. `visible` - *boolean*, *opcional*. O padrão é `true`. Determina se o controle é exibido para o jogador interagir. Para alterar isso durante a jogabilidade, consulte [Alterando layouts de toque usando o estado do jogo](/pt-BR/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-touch-changing-layouts-game-state#change_state). `styles` - *object*, *opcional*. Personalização da representação visual do controle. Os estilos são representados como um objeto por estado que pode ser estilizado. O controle de acelerador pode ter os seguintes estados estilizados. * `default` - O estilo base. * `activated` - Aplicado quando o jogador está tocando no botão e ele está exatamente no valor 0 ao longo do eixo. * `activatedDown` - Aplicado quando o jogador está tocando no botão e o moveu de forma que ele fique na seção negativa (inferior) do eixo do acelerador. * `activatedUp` - Aplicado quando o jogador está tocando no botão e o moveu de forma que ele fique na seção positiva (superior) do eixo do acelerador. * `idle` - Aplicado quando o jogador *não* está interagindo com o controle e o botão também não está fixo (`sticky`) na seção superior do eixo. * `idleUp` - Aplicado quando o jogador *não* está interagindo com o controle, o botão foi movido para a seção superior e `sticky` foi definido como `true`. **Propriedades de estilo por estado** `opacity` - *number*, *opcional*. A opacidade a ser aplicada ao controle. O padrão é 1.0 para todos os estados, exceto `disabled`. [`axisUp`](/pt-BR/reference/system/touchadaptationkit/types/game-streaming-touch-throttle-axis) - *object*, *opcional*. Um objeto [`axis`](/pt-BR/reference/system/touchadaptationkit/types/game-streaming-touch-throttle-axis) que especifica o estilo da parte positiva (superior) do acelerador. [`axisDown`](/pt-BR/reference/system/touchadaptationkit/types/game-streaming-touch-throttle-axis) - *object*, *opcional*. Um objeto [`axis`](/pt-BR/reference/system/touchadaptationkit/types/game-streaming-touch-throttle-axis) que especifica o estilo da parte negativa (inferior) do acelerador. [`knob`](/pt-BR/reference/system/touchadaptationkit/types/game-streaming-touch-knob) - *object*, *opcional*. O objeto [`knob`](/pt-BR/reference/system/touchadaptationkit/types/game-streaming-touch-knob) que especifica o estilo da parte do botão do acelerador. `indicator` - *object*, *opcional*. Um [stroke](/pt-BR/reference/system/touchadaptationkit/types/game-streaming-touch-stroke) que especifica o estilo a ser aplicado ao componente que conecta o botão à posição atual no eixo. **Dimensões dos ativos** Para cada um dos objetos de estilo que aceitam ativos de imagem, um determinado ativo é fornecido em uma resolução base e nas escalas 1.5x, 2.0x, 3.0x e 4.0x dessa resolução base. A resolução de uma determinada imagem deve ser menor ou igual às seguintes resoluções 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 | ## Comentários O controle `throttle` permite que o jogador forneça a pressão variável de um gatilho usando um controle de toque. O controle `throttle` foi projetado para ser posicionado no ponto central da roda e para ser o único controle entre esse ponto e a lateral da tela. Defina `sticky` como true se o jogador provavelmente quiser aplicar uma pressão constante ao gatilho, permitindo que ele defina o valor e depois use os dedos para outras ações. **Comentários sobre estilo** Ao fazer streaming pela versão Windows do Content Test Application, nem todos os estilos serão exibidos corretamente. ## Exemplo #### Exemplo 1: Acelerador básico **Figura 1. Controle de acelerador** Usuário interagindo com um acelerador Este exemplo usa o estilo padrão. ```JSON theme={null} { "type": "throttle", "axisUp": "rightTrigger", "axisDown": "leftTrigger", "sticky": true } ``` #### Exemplo 2: Acelerador com contorno estilizado e ícones definidos explicitamente **Figura 1. Controle de acelerador personalizado** Usuário interagindo com um acelerador personalizado ```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 **Versão do layout:** 1.0+ (estilo disponível a partir da versão de layout 3.2+) ## Related topics - [Touch Adaptation Kit](/es/reference/system/touchadaptationkit/touchadaptationkit-reference.md) - [Plantillas](/es/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-templates.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) - [XApuUtilization](/es/reference/audio/xapu/structs/xapuutilization.md) - [Diseño de controles táctiles de conducción](/es/build/core-features/common/game-streaming/building-touch-layouts/samples/game-streaming-touch-tak-sample-driving.md)