> ## 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.
# Accélérateur
> Accélérateur
# Accélérateur
Version spécialisée d'une manette de jeu limitée à l'axe Y. Conçue pour les jeux de conduite.
## Propriétés
`type` - "throttle"
`axisUp` - *chaîne*. Gâchette à laquelle correspond la partie supérieure du contrôle. Doit être `"leftTrigger"` ou `"rightTrigger"`.
`axisDown` - *chaîne*. Gâchette à laquelle correspond la partie inférieure du contrôle. Doit être `"leftTrigger"` ou `"rightTrigger"`.
`relative` - *booléen*, *facultatif*. Contrôle la façon dont l'accélérateur calcule sa valeur. Si `true`, la valeur est basée sur l'emplacement du toucher initial de l'utilisateur. Si `false`, la valeur est basée sur le point central du contrôle. La valeur par défaut est `true`.
`sticky` - *booléen*, *facultatif*. Contrôle ce qui se produit lorsque l'utilisateur cesse de toucher le contrôle. Si `true`, l'accélérateur reste à la dernière valeur. Si `false`, il est réinitialisé à 0. La valeur par défaut est `false`.
`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 modifier cette valeur 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 d'accélérateur peuvent être stylisés.
* `default` - Le style de base.
* `activated` - Appliqué lorsque le joueur touche le bouton et que celui-ci se trouve exactement à la valeur 0 le long de l'axe.
* `activatedDown` - Appliqué lorsque le joueur touche le bouton et l'a déplacé de sorte qu'il se trouve dans la section négative (inférieure) de l'axe de l'accélérateur.
* `activatedUp` - Appliqué lorsque le joueur touche le bouton et l'a déplacé de sorte qu'il se trouve dans la section positive (supérieure) de l'axe de l'accélérateur.
* `idle` - Appliqué lorsque le joueur n'interagit *pas* avec le contrôle et que le bouton n'est pas non plus maintenu (`sticky`) dans la section supérieure de l'axe.
* `idleUp` - Appliqué lorsque le joueur n'interagit *pas* avec le contrôle, que le bouton a été déplacé dans la section supérieure et que `sticky` a été défini sur `true`.
**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`.
[`axisUp`](/fr-CA/reference/system/touchadaptationkit/types/game-streaming-touch-throttle-axis) - *objet*, *facultatif*. Un objet [`axis`](/fr-CA/reference/system/touchadaptationkit/types/game-streaming-touch-throttle-axis) qui spécifie le style de la partie positive (supérieure) de l'accélérateur.
[`axisDown`](/fr-CA/reference/system/touchadaptationkit/types/game-streaming-touch-throttle-axis) - *objet*, *facultatif*. Un objet [`axis`](/fr-CA/reference/system/touchadaptationkit/types/game-streaming-touch-throttle-axis) qui spécifie le style de la partie négative (inférieure) de l'accélérateur.
[`knob`](/fr-CA/reference/system/touchadaptationkit/types/game-streaming-touch-knob) - *objet*, *facultatif*. L'objet [`knob`](/fr-CA/reference/system/touchadaptationkit/types/game-streaming-touch-knob) qui spécifie le style de la partie bouton de l'accélérateur.
`indicator` - *objet*, *facultatif*. Un [stroke](/fr-CA/reference/system/touchadaptationkit/types/game-streaming-touch-stroke) qui spécifie le style à appliquer au composant reliant le bouton à la position actuelle sur l'axe.
**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 |
| :- | :- | :- | :- | :- | :- |
| knob.faceImage | 60x60 | 90x90 | 120x120 | 180x180 | 240x240 |
| knob.background | 60x60 | 90x90 | 120x120 | 180x180 | 240x240 |
## Remarques
Le contrôle `throttle` permet au joueur de fournir la pression variable d'une gâchette au moyen d'un contrôle tactile.
Le contrôle `throttle` est conçu pour être placé à l'emplacement central de la roue et pour être le seul contrôle entre cet emplacement et le côté de l'écran.
Définissez `sticky` sur true si le joueur voudra probablement appliquer une pression constante sur la gâchette, afin de lui permettre de définir la valeur puis d'utiliser ses doigts pour d'autres actions.
**Remarques sur le style**
Lors de la diffusion en continu au moyen de la version Windows de Content Test Application, certains styles ne s'affichent pas correctement.
## Exemple
#### Exemple 1 : Accélérateur de base
**Figure 1. Contrôle d'accélérateur**
Cet exemple utilise le style par défaut.
```JSON theme={null}
{
"type": "throttle",
"axisUp": "rightTrigger",
"axisDown": "leftTrigger",
"sticky": true
}
```
#### Exemple 2 : Accélérateur avec un contour stylisé et des icônes définies explicitement
**Figure 1. Contrôle d'accélérateur personnalisé**
```JSON theme={null}
{
"type": "throttle",
"axisUp": "rightTrigger",
"axisDown": "leftTrigger",
"sticky": true,
"styles": {
"default": {
"knob" : {
"faceImage" : {
"type": "icon",
"value": "gasPedal"
}
},
"axisUp": {
"stroke" : {
"type": "solid",
"color": "#107C10"
},
"cap" : {
"type": "color",
"value": "#107C10"
}
},
"axisDown": {
"stroke" : {
"type": "solid",
"color": "#ff0000"
},
"cap" : {
"type": "color",
"value": "#ff0000"
}
}
},
"idleUp" : {
"knob" : {
"stroke" : {
"type": "solid",
"color": "#107C10"
}
},
"indicator" : {
"type": "solid",
"color": "#107C10"
}
},
"activatedUp" : {
"indicator" : {
"type": "solid",
"color": "#107C10"
}
},
"activatedDown": {
"knob" : {
"faceImage" : {
"type": "icon",
"value": "brakePedal"
}
},
"indicator" : {
"type": "solid",
"color": "#ff0000"
}
}
}
}
```
## Configuration requise
**Version de la disposition :** 1.0+ (style disponible à partir de la version de disposition 3.2+)