> ## 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.
# Pavé tactile
> Pavé tactile
# Pavé tactile
Contrôle analogique qui permet au joueur d'interagir de façon semblable au pavé tactile d'un ordinateur portable.
## Propriétés
`type` - "touchpad"
`axis` - *objet* ou *tableau*. Un seul [axe](/fr-CA/reference/system/touchadaptationkit/types/game-streaming-touch-axis) ou un tableau d'[axes](/fr-CA/reference/system/touchadaptationkit/types/game-streaming-touch-axis) qui décrivent le mappage de ce contrôle de pavé tactile.
`action` - *objet*, *facultatif*. Une [action](/fr-CA/reference/system/touchadaptationkit/types/game-streaming-touch-action) à appeler au toucher en plus du mappage d'axe.
`renderAsButton` - *booléen*, *facultatif*. La valeur par défaut est `false`. Définissez cette valeur sur `true` pour afficher visuellement le pavé tactile comme un bouton.
`enabled` - *booléen*, *facultatif*. La valeur par défaut est `true`. Définit l'état visuel du contrôle comme activé/désactivé. Un contrôle désactivé recevra toujours les entrées du joueur, mais ne modifiera PAS son style visuel en fonction de ces entrées.
`visible` - *booléen*, *facultatif*. La valeur par défaut est `true`. Détermine si le contrôle est affiché au joueur pour qu'il puisse interagir avec celui-ci. Pour le modifier pendant le jeu, consultez [Modification des dispositions tactiles à l'aide de l'état du jeu](/fr-CA/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-touch-changing-layouts-game-state#change_state).
`styles` - *objet*, *facultatif*. Personnalisation de la représentation visuelle du contrôle. Les styles sont représentés sous forme d'un objet par état pouvant être stylisé.
Les états suivants du contrôle peuvent être stylisés :
* `default` - Le style de base.
* `disabled` - Le style lorsque le contrôle est désactivé. S'il n'est pas spécifié, une transformation est appliquée au style par défaut lorsque le contrôle est désactivé afin qu'il paraisse désactivé.
* `idle` - Appliqué lorsque le joueur n'interagit PAS avec le contrôle.
* `moving` - Appliqué lorsque le joueur touche le contrôle et qu'aucune `action` n'est définie.
* `activated` - Appliqué lorsque le joueur touche le contrôle et qu'une `action` est définie.
**Propriétés de style par état**
`opacity` - *nombre*, *facultatif*. L'opacité à appliquer au contrôle. La valeur par défaut est 1.0 pour tous les états, sauf `disabled`.
`background` - *objet*, *facultatif*. Peut être soit une [couleur](/fr-CA/reference/system/touchadaptationkit/types/game-streaming-touch-color), soit une [ressource d'image](/fr-CA/reference/system/touchadaptationkit/types/game-streaming-touch-asset).
`faceImage` - *objet*, *facultatif*. Peut être soit une [icône](/fr-CA/reference/system/touchadaptationkit/types/game-streaming-touch-icon), soit une [ressource d'image](/fr-CA/reference/system/touchadaptationkit/types/game-streaming-touch-asset).
**Dimensions des ressources**
Pour chacun des objets de style qui acceptent des ressources d'image, une ressource donnée est fournie à une résolution de base et à des échelles de 1.5x, 2.0x, 3.0x et 4.0x de cette résolution de base. La résolution d'une image donnée doit être inférieure ou égale aux résolutions maximales suivantes :
| Objet | @1.0x | @1.5x | @2.0x | @3.0x | @4.0x |
| :- | :- | :- | :- | :- | :- |
| faceImage | 60x60 | 90x90 | 120x120 | 180x180 | 240x240 |
| background (renderAsButton = true) | 60x60 | 90x90 | 120x120 | 180x180 | 240x240 |
| background (renderAsButton = false) | 120x120 | 90x90 | 240x240 | 360x360 | 480x480 |
## Remarques
Le `touchpad` convient le mieux à une sortie non persistante et sans zone morte, généralement la caméra de visée dans un jeu à la première ou à la troisième personne.
Pour les jeux qui prennent en charge l'entrée de la souris, le `touchpad` peut être utilisé avec la souris relative afin d'offrir une expérience de caméra de visée plus précise.
**Remarques sur le style**
Lorsque `renderAsButton` est `true` :
* Dans l'état `activated`, le `faceImage` est affiché 25 % plus petit.
* Des étiquettes et un style par défaut pour la couleur d'arrière-plan sont fournis pour les boutons qui n'utilisent pas de ressources personnalisées et qui ont une seule action parmi `gamepadX`, `gamepadY`, `gamepadA` ou `gamepadB`.
## Exemples
#### Exemple 1 : Pavé tactile avec une icône de visée
**Figure 1. Contrôle de pavé tactile**
```JSON theme={null}
{
"type": "touchpad",
"axis": {
"input": "axisXY",
"output": "rightJoystick",
"sensitivity": 3
},
"styles": {
"default" : {
"faceImage" : {
"type": "icon",
"value": "look"
}
}
}
}
```
#### Exemple 2 : Pavé tactile avec une icône de visée affiché comme un bouton
**Figure 1. Contrôle de pavé tactile en forme de bouton**
```JSON theme={null}
{
"type": "touchpad",
"renderAsButton": true,
"axis": {
"input": "axisXY",
"output": "rightJoystick",
"sensitivity": 3
},
"styles": {
"default" : {
"faceImage" : {
"type": "icon",
"value": "look"
}
}
}
}
```
## Configuration requise
**Version de la disposition :** 1.0+ (style disponible à partir de la version de disposition 3.0+)
## Related topics
- [Publicación de diseños táctiles](/es/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-touch-publishing-layouts.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)
- [Diseño de controles táctiles de lucha](/es/build/core-features/common/game-streaming/building-touch-layouts/samples/game-streaming-touch-tak-sample-fighter.md)
- [Compilación de diseños de controles táctiles](/es/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-touch-building-touch-layout.md)
- [Guía del diseñador para crear controles táctiles](/es/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-designers-guide.md)