> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Couche

> Couche (expérimental)

# Couche (expérimental)

Disposition tactile enfant qui peut être superposée à la disposition tactile de base.

> [!WARNING]
>
> Les couches sont actuellement disponibles sous forme expérimentale et leur comportement pourrait changer en fonction des commentaires des premiers utilisateurs.

## Propriétés

L'objet de couche nommé contient les propriétés suivantes.

`center` - *objet*, *facultatif*. [Roue](https://docs.xbox.com/fr-CA/reference/system/touchadaptationkit/layout/game-streaming-touch-wheel.md) de contrôles affichée au centre de l'écran.

`left` - *objet*, *facultatif*. [Roue](https://docs.xbox.com/fr-CA/reference/system/touchadaptationkit/layout/game-streaming-touch-wheel.md) de contrôles affichée par défaut sous la main gauche ou le pouce gauche du joueur.

`lower` - *objet*, *facultatif*. Objet qui vous permet de placer des contrôles dans l'un des trois emplacements `leftCenter`, `center` ou `rightCenter` de la rangée inférieure de contrôles.

`right` - *objet*, *facultatif*. [Roue](https://docs.xbox.com/fr-CA/reference/system/touchadaptationkit/layout/game-streaming-touch-wheel.md) de contrôles affichée par défaut sous la main droite ou le pouce droit du joueur.

`upper` - *objet*, *facultatif*. Objet qui vous permet de placer un tableau de contrôles dans les emplacements `right` de la rangée supérieure de contrôles.

## Remarques

Lorsqu'une `layer` est utilisée, dans chacun des emplacements où un `control` serait utilisé dans une disposition normale (aux emplacements `center`, `left`, `lower`, `right`, `upper`), vous pouvez inclure un contrôle pour remplacer ce qui était affiché auparavant, ou utiliser un contrôle [`blank`](https://docs.xbox.com/fr-CA/reference/system/touchadaptationkit/controls/game-streaming-touch-blank) pour masquer ce qui était affiché auparavant dans cet emplacement.

Pour qu'une `layer` soit affichée, vous devez disposer d'un contrôle [`button`](https://docs.xbox.com/fr-CA/reference/system/touchadaptationkit/controls/game-streaming-touch-button) doté d'une [action de couche](https://docs.xbox.com/fr-CA/reference/system/touchadaptationkit/layout/game-streaming-touch-layer-action.md) qui provoquera l'affichage de la disposition.

## Exemple

Cet exemple commence par une disposition simple de jeu de plateforme, avec un bouton en haut à droite pour basculer l'affichage d'une couche comportant des capacités avancées.

![Joueur interagissant avec la disposition et utilisant une couche pour afficher des contrôles supplémentaires](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/reference/game-streaming-touch-control-images-layer-special-ability.gif?s=75cb7f41bedfbe02eb6548681a548576)

```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"
                                    }
                                }
                            }
                        }
                    ]
                }
            }
        }
    }
}

```

## Voir aussi

[Référence du Touch Adaptation Kit](https://docs.xbox.com/fr-CA/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-kit-overview.md)\
[Contrôle vide](https://docs.xbox.com/fr-CA/reference/system/touchadaptationkit/controls/game-streaming-touch-blank.md)\
[Action de couche](https://docs.xbox.com/fr-CA/reference/system/touchadaptationkit/layout/game-streaming-touch-layer-action.md)\
[Disposition](https://docs.xbox.com/fr-CA/reference/system/touchadaptationkit/layout/game-streaming-touch-layout.md)


## Related topics

- [Action de couche](https://docs.xbox.com/fr-CA/reference/system/touchadaptationkit/layout/game-streaming-touch-layer-action.md)
- [ClearUnorderedAccessViewUint](https://docs.xbox.com/fr-CA/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_clearunorderedaccessviewuint_public.md)
- [ClearUnorderedAccessViewFloat](https://docs.xbox.com/fr-CA/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_clearunorderedaccessviewfloat_public.md)
- [ExecuteBundle](https://docs.xbox.com/fr-CA/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_executebundle_public.md)
- [Référence de la trousse d'adaptation tactile (TAK)](https://docs.xbox.com/fr-CA/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-kit-overview.md)