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

# Camada (experimental)

> Camada (experimental)

# Camada (experimental)

Um layout de toque filho que pode ser sobreposto ao layout de toque base.

<Warning>As camadas estão atualmente disponíveis para uso em formato experimental e podem mudar de comportamento com base nos comentários dos primeiros usuários.</Warning>

## Propriedades

O objeto de camada nomeado contém as seguintes propriedades.

`center` - *object*, *opcional*. [Roda](/pt-BR/reference/system/touchadaptationkit/layout/game-streaming-touch-wheel) de controles exibida no centro da tela.

`left` - *object*, *opcional*. [Roda](/pt-BR/reference/system/touchadaptationkit/layout/game-streaming-touch-wheel) de controles exibida, por padrão, sob a mão/polegar esquerdo do jogador.

`lower` - *object*, *opcional*. Um objeto que permite posicionar controles em qualquer um dos três slots `leftCenter`, `center` ou `rightCenter` na linha inferior de controles.

`right` - *object*, *opcional*. [Roda](/pt-BR/reference/system/touchadaptationkit/layout/game-streaming-touch-wheel) de controles exibida, por padrão, sob a mão/polegar direito do jogador.

`upper` - *object*, *opcional*. Um objeto que permite posicionar uma matriz de controles nos slots `right` na linha superior de controles.

## Comentários

Quando uma `layer` é utilizada, em cada um dos slots onde um `control` seria utilizado em um layout normal (nos locais `center`, `left`, `lower`, `right`, `upper`), você pode incluir um controle para substituir o que estava sendo exibido anteriormente ou utilizar um controle [`blank`](/pt-BR/reference/system/touchadaptationkit/controls/game-streaming-touch-blank) para ocultar o que estava sendo exibido anteriormente nesse slot.

Para que uma `layer` seja exibida, você deve ter um controle [`button`](/pt-BR/reference/system/touchadaptationkit/controls/game-streaming-touch-button) com uma [ação de camada](/pt-BR/reference/system/touchadaptationkit/layout/game-streaming-touch-layer-action) que fará com que o layout seja exibido.

## Exemplo

Este exemplo começa com um layout simples de jogo de plataforma, com um botão no canto superior direito para alternar a exibição de uma camada com habilidades avançadas.

<img src="https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/reference/game-streaming-touch-control-images-layer-special-ability.gif?s=75cb7f41bedfbe02eb6548681a548576" alt="Jogador interagindo com o layout e usando uma camada para expor controles adicionais" width="520" height="246" data-path="images/gdk/reference/game-streaming-touch-control-images-layer-special-ability.gif" />

```JSON theme={null}
{
    "$schema": "https://raw.githubusercontent.com/microsoft/xbox-game-streaming-tools/main/touch-adaptation-kit/schemas/layout/v3.1/layout.json",
    "content": {
        "left": {
            "inner": [
                {
                    "type": "directionalPad",
                    "scale": 1.5
                }
            ]
        },
        "right": {
            "inner": [
                {
                    "type": "button",
                    "action": "gamepadY",
                    "styles": {
                        "default": {
                            "faceImage": {
                                "type": "icon",
                                "value": "dash"
                            }
                        }
                    }
                },
                {
                    "type": "button",
                    "action": "gamepadA",
                    "styles": {
                        "default": {
                            "faceImage": {
                                "type": "icon",
                                "value": "jump"
                            }
                        }
                    }
                }
            ],
            "outer": [
                null,
                {
                    "type": "button",
                    "action": "gamepadB",
                    "styles": {
                        "default": {
                            "faceImage": {
                                "type": "icon",
                                "value": "specialAbility"
                            }
                        }
                    }
                },
                null,
                null,
                {
                    "type": "button",
                    "action": "gamepadX",
                    "styles": {
                        "default": {
                            "faceImage": {
                                "type": "icon",
                                "value": "fire"
                            }
                        }
                    }
                }
            ]
        },
        "upper": {
            "right": [
                {
                    "type": "button",
                    "action": {
                        "type": "layer",
                        "target": "selectAbility"
                    },
                    "styles": {
                        "default": {
                            "faceImage": {
                                "type": "icon",
                                "value": "add"
                            }
                        }
                    },
                    "toggle" : true
                },
                {
                    "type": "button",
                    "action": "view"
                },
                {
                    "type": "button",
                    "action": "menu"
                }
            ]
        },
        "layers": {
            "selectAbility": {
                "right": {
                    "outer": [
                        null,
                        null,
                        null,
                        null,
                        null,
                        null,
                        {
                            "type": "button",
                            "action": "rightBumper",
                            "styles": {
                                "default": {
                                    "faceImage": {
                                        "type": "icon",
                                        "value": "ability2"
                                    }
                                }
                            }
                        },
                        {
                            "type": "button",
                            "action": "leftBumper",
                            "styles": {
                                "default": {
                                    "faceImage": {
                                        "type": "icon",
                                        "value": "ability"
                                    }
                                }
                            }
                        }
                    ]
                }
            }
        }
    }
}

```

## Consulte também

[Referência do Touch Adaptation Kit](/pt-BR/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-kit-overview)\
[Controle Blank](/pt-BR/reference/system/touchadaptationkit/controls/game-streaming-touch-blank)\
[Ação de camada](/pt-BR/reference/system/touchadaptationkit/layout/game-streaming-touch-layer-action)\
[Layout](/pt-BR/reference/system/touchadaptationkit/layout/game-streaming-touch-layout)


## Related topics

- [D3D12EnableExperimentalFeatures](/reference/graphics/d3d12/functions/d3d12enableexperimentalfeatures_public.md)
- [Portar de outras plataformas](/pt-BR/paths/porting/from-console.md)
- [Portar de uma geração anterior de XBOX](/pt-BR/paths/porting/from-xbox-era.md)
- [Análise de Modo de Falha (FMA) da Certificação XBOX](/pt-BR/publishing/certification/fma/overview.md)
- [Touch Adaptation Kit (TAK) Reference](/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-kit-overview.md)