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

# Roue

> Roue

# Roue

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

## Propriétés

[`inner`](/fr-CA/reference/system/touchadaptationkit/layout/game-streaming-touch-inner-wheel) - *object*, *facultatif*. Jusqu'à quatre contrôles disposés dans la partie [intérieure](/fr-CA/reference/system/touchadaptationkit/layout/game-streaming-touch-inner-wheel) 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](/fr-CA/reference/system/touchadaptationkit/layout/game-streaming-touch-control-cluster-outer), 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](/fr-CA/reference/system/touchadaptationkit/layout/game-streaming-touch-control-cluster-outer) 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.</Note>

<img src="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" alt="Personnalisation des roues par le joueur" width="545" height="270" data-path="images/gdk/reference/game-streaming-touch-control-images-wheel-ergo.jpg" />

**Conseils**

* La zone [`inner`](/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

<img src="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" alt="Roue avec un joystick dans l'emplacement intérieur et des boutons personnalisés dans chaque emplacement extérieur" width="375" height="375" data-path="images/gdk/reference/game-streaming-touch-control-images-wheel-example.png" />

```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

<img src="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" alt="Roue avec un joystick dans l'emplacement intérieur et des boutons personnalisés dans chaque emplacement extérieur" width="626" height="626" data-path="images/gdk/reference/game-streaming-touch-control-images-wheel-left-dpad.png" />

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

<img src="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" alt="Roue avec un joystick dans l'emplacement intérieur et des boutons personnalisés dans chaque emplacement extérieur" width="626" height="626" data-path="images/gdk/reference/game-streaming-touch-control-images-wheel-right.png" />

```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](/fr-CA/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-kit-overview)\
[Disposition](/fr-CA/reference/system/touchadaptationkit/layout/game-streaming-touch-layout)


## Related topics

- [PFGroupsGroupRole](/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsgrouprole.md)
- [PFGroupsGroupWithRoles](/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsgroupwithroles.md)
- [PFGroupsCreateGroupRoleRequest](/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupscreategrouprolerequest.md)
- [PFGroupsCreateGroupRoleResponse](/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupscreategrouproleresponse.md)
- [PFGroupsUpdateGroupRoleResponse](/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsupdategrouproleresponse.md)
