> ## 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 similaire au pavé tactile d'un ordinateur portable.
## Propriétés
`type` - "touchpad"
`axis` - *objet* ou *tableau*. Un [axe](/fr/reference/system/touchadaptationkit/types/game-streaming-touch-axis) unique ou un tableau d'[axes](/fr/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/reference/system/touchadaptationkit/types/game-streaming-touch-action) à appeler lors du toucher, en plus du mappage d'axe.
`renderAsButton` - *booléen*, *facultatif*. Valeur par défaut : `false`. Définissez cette valeur sur `true` pour afficher visuellement le pavé tactile sous la forme d'un bouton.
`enabled` - *booléen*, *facultatif*. Valeur par défaut : `true`. Définit l'état visuel du contrôle sur activé/désactivé. Un contrôle désactivé continue de recevoir les entrées du joueur, mais ne modifie PAS son style visuel en fonction de ces entrées.
`visible` - *booléen*, *facultatif*. Valeur par défaut : `true`. Détermine si le contrôle est affiché au joueur pour qu'il puisse interagir avec. Pour le modifier en cours de jeu, consultez [Modification des dispositions tactiles à l'aide de l'état du jeu](/fr/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 la forme d'un objet par état pouvant être stylisé.
Les états suivants du contrôle de bouton 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é pour lui donner un aspect 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. Valeur par défaut : 1.0 pour tous les états sauf `disabled`.
`background` - *objet*, *facultatif*. Peut être une [couleur](/fr/reference/system/touchadaptationkit/types/game-streaming-touch-color) ou une [ressource image](/fr/reference/system/touchadaptationkit/types/game-streaming-touch-asset).
`faceImage` - *objet*, *facultatif*. Peut être une [icône](/fr/reference/system/touchadaptationkit/types/game-streaming-touch-icon) ou une [ressource image](/fr/reference/system/touchadaptationkit/types/game-streaming-touch-asset).
**Dimensions des ressources**
Pour chacun des objets de style qui acceptent des ressources image, une ressource donnée est fournie à une résolution de base ainsi qu'aux échelles 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` est idéal pour 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 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`, `faceImage` est affiché 25 % plus petit.
* Des étiquettes et un style par défaut de la couleur d'arrière-plan sont prévus pour les boutons qui n'utilisent pas de ressources personnalisées et qui ont une action unique `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é sous la forme d'un bouton
**Figure 1. Contrôle de pavé tactile en 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)