> ## 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.
# Mode contraste élevé
> Mode contraste élevé
Selon le jeu de couleurs de votre titre, il peut arriver que vos dispositions tactiles soient difficiles à voir, car elles contrastent mal avec votre titre exécuté dans le flux sous-jacent. Cela peut être particulièrement problématique pour les joueurs malvoyants, daltoniens ou atteints d'autres déficiences visuelles. Le mode contraste élevé est un paramètre client qui, lorsqu'il est activé, ajoute des contours supplémentaires et des plaques d'arrière-plan aux boutons stylisés avec une [icône](/fr/reference/system/touchadaptationkit/types/game-streaming-touch-icon), et modifie les [couleurs système](/fr/reference/system/touchadaptationkit/layout/game-streaming-touch-color-palette#system-colors) pour augmenter le contraste.
Par exemple, voici la disposition standard sur une couleur d'arrière-plan unie claire, avec le mode contraste élevé **désactivé** :
Et voici la même configuration avec le mode contraste élevé **activé** :
Vous pouvez vous appuyer sur les valeurs système par défaut pour le style du mode contraste élevé, mais vous pouvez également inclure des [variantes à contraste élevé de vos ressources personnalisées](#custom-assets-for-high-contrast-mode) et [remplacer les couleurs système](#overriding-system-colors-for-high-contrast-mode) pour correspondre à l'esthétique visuelle de votre jeu.
## Ressources personnalisées pour le mode contraste élevé
Lorsque vous utilisez des [ressources personnalisées](/fr/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-custom-assets) dans votre bundle d'adaptation tactile, vous pouvez inclure des variantes à contraste élevé pour chacune de vos ressources à contraste standard. Ces variantes à contraste élevé sont ensuite affichées chaque fois que le mode contraste élevé est activé. Une ressource est marquée comme variante à contraste élevé en ajoutant un suffixe `.hc` après le nom de la ressource et avant l'extension de fichier. Par exemple, considérez `myAsset.png` (à gauche) et sa variante à contraste élevé, `myAsset.hc.png` (à droite) :
Lorsque vous organisez vos ressources sur le disque, les ressources à contraste standard et à contraste élevé sont [organisées par langue et par échelle de ressource](/fr/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-custom-assets#asset-files) comme d'habitude. Pour les ressources ci-dessus, la structure de fichiers pourrait ressembler à ceci :
```
assets/
└───neutral/
├───@1.0x/
│ myAsset.png
│ myAsset.hc.png
├───@1.5x/
│ myAsset.png
│ myAsset.hc.png
├───@2.0x/
│ myAsset.png
│ myAsset.hc.png
├───@3.0x/
│ myAsset.png
│ myAsset.hc.png
└───@4.0x/
myAsset.png
myAsset.hc.png
```
Dans une disposition, les ressources sont référencées [sans l'extension de fichier](/fr/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-custom-assets#referencing-assets-from-layouts) **et sans le suffixe `.hc`**. Par exemple, un bouton stylisé avec les ressources ci-dessus pourrait être configuré ainsi :
```JSON theme={null}
{
"type": "button",
"action": "gamepadA",
"styles": {
"idle": {
"faceImage": {
"type": "asset",
"value": "myAsset"
}
}
}
}
```
Avec ce style, le Touch Adaptation Kit sélectionne automatiquement `myAsset.png` ou `myAsset.hc.png` selon que le mode contraste élevé est désactivé ou activé, respectivement. Ce style donne le résultat suivant lorsque le mode contraste élevé est **désactivé** :
Et le résultat suivant lorsque le mode contraste élevé est **activé** :
## Remplacement des couleurs système pour le mode contraste élevé
Les [palettes de couleurs](/fr/reference/system/touchadaptationkit/layout/game-streaming-touch-color-palette) de vos dispositions tactiles ou de votre [fichier de contexte](/fr/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-bundle#context) peuvent être utilisées pour remplacer les [couleurs système](/fr/reference/system/touchadaptationkit/layout/game-streaming-touch-color-palette#system-colors). Les commandes utilisent implicitement les couleurs système pour leur style, ce qui signifie que tout remplacement affecte le style global de toutes les commandes (sauf si une commande possède son propre remplacement dans un bloc `styles` personnalisé).
Par exemple, la disposition suivante remplace certaines couleurs système pour obtenir un style personnalisé lorsque le mode contraste élevé est activé :
```JSON theme={null}
{
"$schema": "https://raw.githubusercontent.com/microsoft/xbox-game-streaming-tools/main/touch-adaptation-kit/schemas/layout/v4.0/layout.json",
"styles": {
"colors": {
"highContrast": {
"system_contentPrimary": "#ff00ffff",
"system_contentSecondary": "#00ff00aa",
"system_contrastPrimary": "#ff0000aa"
}
}
},
"content": {
"left": {
"inner": [
{
"type": "joystick",
"axis": {
"input": "axisXY",
"output": "leftJoystick"
}
},
{
"type": "button",
"action": "dPadRight",
"styles": {
"default": {
"faceImage": {
"type": "icon",
"value": "map"
}
}
}
}
]
},
"right": {
"inner": [
{
"type": "button",
"action": "gamepadY"
},
{
"type": "button",
"action": "gamepadB"
},
{
"type": "button",
"action": "gamepadA"
},
{
"type": "button",
"action": "gamepadX"
}
]
}
}
}
```
Dans la disposition ci-dessus, trois remplacements de couleurs sont déclarés dans le bloc `highContrast`, qui ne seront appliqués que lorsque le mode contraste élevé est activé :
1. `system_contentPrimary` remplacera le style appliqué au contour central du joystick et à la teinte de l'icône de carte.
2. `system_contentSecondary` remplacera le style appliqué au remplissage du joystick.
3. `system_contrastPrimary` remplacera le style appliqué au contour extérieur du joystick et aux plaques d'arrière-plan des boutons.
La disposition ci-dessus avec le mode contraste élevé **désactivé** :
Et avec le mode contraste élevé **activé** :
## Activation du mode contraste élevé
Vous pouvez tester le mode contraste élevé sur l'une des applications de test de contenu (CTA) [web](#web-cta), [Android](#android-cta) ou [Windows](#windows-cta).
### CTA web
Pour activer le mode contraste élevé sur la [CTA web](/fr/build/core-features/common/game-streaming/game-streaming-web-content-test-application) :
Cliquez sur votre profil et accédez à la fenêtre « Paramètres » :
Accédez à « Accessibilité » et cochez « Activer le contraste élevé en jeu » :
### CTA Android (déconseillée)
Pour activer le mode contraste élevé sur la [CTA Android](/fr/build/core-features/common/game-streaming/game-streaming-android-content-test-application) :
Cliquez sur votre profil :
Cochez « Activer le mode contraste élevé » :
### CTA Windows (déconseillée)
Pour activer le mode contraste élevé sur la [CTA Windows](/fr/build/core-features/common/game-streaming/game-streaming-windows-pc-content-test-application) :
Cliquez sur votre profil :
Cochez « Activer le mode contraste élevé » :
## Related topics
- [Vue d'ensemble de l'accessibilité GDK](/fr/build/game-principles/accessibility/accessibility-overview.md)
- [XAG 102: Contraste](/es/build/game-principles/accessibility/xag-deep-dives/xag-102-contrast.md)
- [Modo de contraste alto](/es/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-high-contrast-mode.md)
- [XHighContrastMode](/es/reference/system/xaccessibility/enums/xhighcontrastmode.md)
- [XHighContrastGetMode](/es/reference/system/xaccessibility/functions/xhighcontrastgetmode.md)