> ## 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.

# Roue

> Roue

# Roue

Un ensemble de contrôles tactiles disposés dans une zone circulaire intérieure et extérieure.

## Propriétés

[`inner`](https://docs.xbox.com/fr-CA/reference/system/touchadaptationkit/layout/game-streaming-touch-inner-wheel) - *object*, *facultatif*. Jusqu'à quatre contrôles disposés dans la partie [intérieure](https://docs.xbox.com/fr-CA/reference/system/touchadaptationkit/layout/game-streaming-touch-inner-wheel.md) de la roue.

`outer` - *array*, *facultatif*. Un tableau comprenant jusqu'à 8 emplacements pouvant être remplis par des contrôles ou des [grappes de contrôles](https://docs.xbox.com/fr-CA/reference/system/touchadaptationkit/layout/game-streaming-touch-control-cluster-outer.md), placés autour de la zone intérieure de la zone circulaire représentée par la `wheel`.

* Le premier emplacement de la zone `outer` commence en haut de la roue (vers 1 heure) et se poursuit dans le sens horaire.
* Un emplacement peut être ignoré avec `null`.
* Une [grappe de contrôles](https://docs.xbox.com/fr-CA/reference/system/touchadaptationkit/layout/game-streaming-touch-control-cluster-outer.md) occupe toujours 2 des 8 emplacements disponibles : l'emplacement dans lequel elle est spécifiée et le suivant.

## Remarques

> [!NOTE]
>
> La taille et la rotation du contrôle `wheel` peuvent être ajustées par le joueur. Lorsqu'il personnalise selon ses préférences, le joueur peut modifier à la fois la taille et la rotation des roues.

![Personnalisation des roues par le joueur](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/reference/game-streaming-touch-control-images-wheel-ergo.jpg?fit=max\&auto=format\&n=gzrdvT5kpqAXKEQt\&q=85\&s=5667dfc8d7806d65a78055f5882ae16b)

**Conseils**

* La zone [`inner`](https://docs.xbox.com/fr-CA/reference/system/touchadaptationkit/layout/game-streaming-touch-inner-wheel) doit servir à positionner le ou les contrôles qui doivent être les plus accessibles au joueur pour cette main.
* L'emplacement `inner` de gauche doit être utilisé pour le contrôle principal de déplacement du joueur.
* Les emplacements `outer` qui obligent le joueur à déplacer sa main pour les atteindre doivent être utilisés pour les commandes peu fréquemment utilisées.

## Exemples

##### Exemple 1 : Exemple de roue avec un joystick au centre et un bouton personnalisé dans chaque emplacement extérieur

![Roue avec un joystick dans l'emplacement intérieur et des boutons personnalisés dans chaque emplacement extérieur](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/reference/game-streaming-touch-control-images-wheel-example.png?fit=max\&auto=format\&n=gzrdvT5kpqAXKEQt\&q=85\&s=599295a273b9d668d862d2d7b4c0e7c3)

```JSON theme={null}
"left": {
    "inner": [
        {
            "type": "joystick",
            "axis": {
                "input": "axisXY",
                "output": "leftJoystick",
                "deadzone": {
                    "threshold": 0.05,
                    "radial": true
                }
            }
        }
    ],
    "outer" : [
        {
            "type": "button",
            "action": "gamepadX",
            "styles": {
                "default" : {
                    "faceImage" : {
                        "type": "asset",
                        "value": "one"
                    },
                    "background" : {
                        "type": "color",
                        "value": "#80808080"
                    }
                }
            }
        },
        {
            "type": "button",
            "action": "gamepadX",
            "styles": {
                "default" : {
                    "faceImage" : {
                        "type": "asset",
                        "value": "two"
                    },
                    "background" : {
                        "type": "color",
                        "value": "#80808080"
                    }
                }
            }
        },
        {
            "type": "button",
            "action": "gamepadX",
            "styles": {
                "default" : {
                    "faceImage" : {
                        "type": "asset",
                        "value": "three"
                    },
                    "background" : {
                        "type": "color",
                        "value": "#80808080"
                    }
                }
            }
        },
        {
            "type": "button",
            "action": "gamepadX",
            "styles": {
                "default" : {
                    "faceImage" : {
                        "type": "asset",
                        "value": "four"
                    },
                    "background" : {
                        "type": "color",
                        "value": "#80808080"
                    }
                }
            }
        },
        {
            "type": "button",
            "action": "gamepadX",
            "styles": {
                "default" : {
                    "faceImage" : {
                        "type": "asset",
                        "value": "five"
                    },
                    "background" : {
                        "type": "color",
                        "value": "#80808080"
                    }
                }
            }
        },
        {
            "type": "button",
            "action": "gamepadX",
            "styles": {
                "default" : {
                    "faceImage" : {
                        "type": "asset",
                        "value": "six"
                    },
                    "background" : {
                        "type": "color",
                        "value": "#80808080"
                    }
                }
            }
        },
        {
            "type": "button",
            "action": "gamepadX",
            "styles": {
                "default" : {
                    "faceImage" : {
                        "type": "asset",
                        "value": "seven"
                    },
                    "background" : {
                        "type": "color",
                        "value": "#80808080"
                    }
                }
            }
        },
        {
            "type": "button",
            "action": "gamepadX",
            "styles": {
                "default" : {
                    "faceImage" : {
                        "type": "asset",
                        "value": "eight"
                    },
                    "background" : {
                        "type": "color",
                        "value": "#80808080"
                    }
                }
            }
        }
    ]
}
```

##### Exemple 2 : Exemple de roue gauche avec un pavé directionnel et un bouton de carte

![Roue avec un joystick dans l'emplacement intérieur et des boutons personnalisés dans chaque emplacement extérieur](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/reference/game-streaming-touch-control-images-wheel-left-dpad.png?fit=max\&auto=format\&n=gzrdvT5kpqAXKEQt\&q=85\&s=d8ae823b5c086b2e1592b67595d72d62)

```JSON theme={null}
 "left": {
    "inner": [
        {
            "type": "directionalPad",
            "scale": 1.5
        }
    ],
    "outer" : [
        {
            "type": "button",
            "action": "leftBumper",
            "styles": {
                "default" : {
                    "faceImage" : {
                        "type": "icon",
                        "value": "map"
                    }
                }
            }
        },
        null,
        null,
        null,
        null,
        null,
        null
    ]
}
```

##### Exemple 3 : Exemple de roue droite avec trois boutons

Les boutons sont alignés sur les emplacements les plus faciles à atteindre pour la main droite. Les boutons de la zone `outer` sont disposés en grappe afin d'offrir une zone tactile plus grande.

![Roue avec un joystick dans l'emplacement intérieur et des boutons personnalisés dans chaque emplacement extérieur](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/reference/game-streaming-touch-control-images-wheel-right.png?fit=max\&auto=format\&n=gzrdvT5kpqAXKEQt\&q=85\&s=ce9650dc3dafefa9a63a695f6fa5402f)

```JSON theme={null}
"right": {
    "inner": [
    {
        "type": "button",
        "action": "gamepadX",
        "styles": {
        "default": {
            "faceImage": {
            "type": "icon",
            "value": "sword"
            }
        }
        }
    }
    ],
    "outer": [
    [
        {
            "type": "button",
            "action": "gamepadB",
            "styles": {
                "default": {
                "faceImage": {
                    "type": "icon",
                    "value": "interact"
                }
                }
            }
        },
        null
    ],
    null,
    [
        {
            "type": "button",
            "action": "gamepadA",
            "styles": {
                "default": {
                "faceImage": {
                    "type": "icon",
                    "value": "jump"
                }
                }
            }
        },
        null
    ]
    ]
}

```

## 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)\
[Disposition](https://docs.xbox.com/fr-CA/reference/system/touchadaptationkit/layout/game-streaming-touch-layout.md)


## Related topics

- [Roue intérieure](https://docs.xbox.com/fr-CA/reference/system/touchadaptationkit/layout/game-streaming-touch-inner-wheel.md)
- [Guide du concepteur pour la création de commandes tactiles](https://docs.xbox.com/fr-CA/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-designers-guide.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)
- [Touch Adaptation Kit](https://docs.xbox.com/fr-CA/reference/system/touchadaptationkit/touchadaptationkit-reference.md)
- [Modèles](https://docs.xbox.com/fr-CA/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-templates.md)
