> ## 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. # Direcional > Direcional # Direcional Um controle direcional que sempre é mapeado para o direcional do gamepad. ## Propriedades `type` - *"directionalPad"*. Especifica o tipo de controle. `scale` - *number*, *opcional*. O padrão é 1. Multiplicador de tamanho, útil porque os direcionais são posicionados como botões e não são dimensionados automaticamente como os joysticks. `deadzone` - *number*, *opcional*. Um valor entre 0 e 1 que especifica o tamanho da zona morta como uma porcentagem do controle. Observe que, diferentemente da [zona morta](/pt-BR/reference/system/touchadaptationkit/types/game-streaming-touch-deadzone) dos joysticks, as zonas mortas do direcional são sempre axiais (quadradas). `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 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. `interaction` - *object*, *opcional*. Definições de propriedades que podem alterar os mecanismos de interação do usuário com o controle **Interação** `activationType` - *string*, *opcional*. Define o tipo de ativação permitido para qualquer direção na interação do direcional. O padrão é `allowNeighboring`. Quando definido como `exclusive`, somente uma única direção pode ser ativada no direcional por vez (ou seja, apenas uma entre 'Up', 'Right', 'Down' ou 'Left'). Quando definido como `allowNeighboring`, uma direção e qualquer uma de suas direções vizinhas podem ser ativadas simultaneamente tocando entre elas (ou seja, o usuário pode ativar 'Up+Right', 'Right+Down', 'Down+Left' ou 'Left+Up' tocando entre cada uma delas, além de poder ativar cada direção individualmente). **Estados e propriedades de estilo** O controle direcional pode ter os seguintes estados estilizados: * `default` - O estilo base. * `disabled` - O estilo quando o controle está desabilitado. Se não for especificado, quando o controle estiver desabilitado, uma transformação será aplicada ao estilo padrão para que ele pareça desabilitado. * `idle` - Aplicado quando o jogador NÃO está interagindo com o controle. * `activated` - Aplicado quando o jogador está tocando no botão. As seguintes propriedades podem ser usadas para estilizar o controle direcional: `opacity` - *number*, *opcional*. A opacidade a ser aplicada ao controle. O padrão é 1.0 para todos os estados, exceto `disabled`. `fill` - *object*, *opcional*. Um objeto com uma cor definida para o gradiente a ser usado quando o direcional é ativado. `gradient` - *object*, *opcional*. Um objeto com uma cor definida para o gradiente a ser usado quando o direcional é ativado. `background` - *object*, *opcional*. Pode ser uma [cor](/pt-BR/reference/system/touchadaptationkit/types/game-streaming-touch-color) ou um [ativo de imagem](/pt-BR/reference/system/touchadaptationkit/types/game-streaming-touch-asset). `stroke` - *object*, *opcional*. Cor a ser usada no contorno do direcional. Deve ser um objeto [stroke](/pt-BR/reference/system/touchadaptationkit/types/game-streaming-touch-stroke). **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 | | :- | :- | :- | :- | :- | :- | | background | 75x75 | 112x112 | 150x150 | 225x225 | 300x300 | ## Comentários O direcional é usado para fornecer uma experiência semelhante à do direcional do controle físico. Se ele estiver sendo usado como o principal mecanismo de movimento do jogador (normalmente no slot `left` `inner`), é recomendável usar uma escala de 2. **Comentários sobre estilo** Se você usar um ativo de imagem personalizado para o `background`, as resoluções máximas mencionadas são para scale=1.0. Se usar uma escala diferente, as resoluções máximas serão iguais ao produto da resolução pela escala. Por exemplo, scale=1.5 implica que uma imagem de fundo de DPI @1.0x pode ter uma resolução máxima de 90x90. Ao fazer streaming pela versão Windows do Content Test Application, nem todos os estilos serão exibidos corretamente. ## Exemplos #### Exemplo 1: Direcional padrão **Figura 1. Direcional** Usuário interagindo com um direcional ``` { "type": "directionalPad", "scale": 1.0 } ``` #### Exemplo 2: Direcional maior com cores personalizadas. **Figura 1. Direcional personalizado** Usuário interagindo com um direcional personalizado ``` { "type": "directionalPad" , "scale": 2.0, "styles" : { "default" : { "fill" : "#0e7a0d10", "gradient" : { "color": "#0e7a0d10" }, "stroke" : { "type": "solid", "color" : "#0e7a0dff" } } } } ``` ## Requisitos **Versão do layout:** 1.0+, (suporte a estilo na 3.0+, suporte a interação na 3.4+). ## Related topics - [Tags de recursos de acessibilidade](/pt-BR/build/game-principles/accessibility/accessibility-feature-tags.md) - [Guia passo a passo da certificação](/pt-BR/publishing/game-publishing/concepts/certification/certification-guide.md) - [Terminologia](/pt-BR/publishing/certification/console-cert-terminology.md) - [Terminology](/publishing/certification/console-cert-terminology.md) - [Terminología](/es/publishing/certification/console-cert-terminology.md)