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

# Groupe de contrôles

> Groupe de contrôles

# Groupe de contrôles

Un tableau de quatre contrôles au maximum qui peut être utilisé pour occuper deux emplacements dans la partie extérieure de la roue.

## Remarques

Le groupe de contrôles peut être utilisé pour contrôler plus finement l'emplacement où les contrôles tactiles seront affichés dans la partie `outer` de la [`wheel`](/fr/reference/system/touchadaptationkit/layout/game-streaming-touch-wheel).

Les utilisations courantes sont notamment les suivantes :

* Faire occuper deux emplacements `outer` d'une [`wheel`](/fr/reference/system/touchadaptationkit/layout/game-streaming-touch-wheel) par un seul contrôle. C'est généralement utilisé lorsque vous souhaitez une zone de toucher plus grande pour un bouton de la section `outer`.
* Étendre les options de disposition dans les emplacements `outer` en créant des groupes de trois ou quatre contrôles dans une configuration en triangle ou en carré.

<Warning>Il est possible d'utiliser des groupes de contrôles pour créer des regroupements de contrôles qui dépassent les limites prévues de la `wheel`. Lorsque vous utilisez plusieurs contrôles, vérifiez que le comportement est celui souhaité sur les appareils à petit écran.</Warning>

***

**Modèles de groupe de contrôles dans la zone `outer wheel`**

> Les images montrent le rendu complet de la roue avec un joystick dans l'emplacement intérieur et la disposition `outer` telle que spécifiée.

#### Modèle 1. Un contrôle couvrant deux emplacements extérieurs

<img src="https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/reference/game-streaming-touch-control-images-wheel-outer-span-two-slots.gif?s=578fa354436743f76172825454a4e17c" alt="Un contrôle couvrant deux emplacements extérieurs" width="400" height="400" data-path="images/gdk/reference/game-streaming-touch-control-images-wheel-outer-span-two-slots.gif" />

Dans cet exemple, observez la zone cible de toucher du bouton.

```JSON theme={null}
{
    "outer": [
        [
            {
                "type": "button",
                "action": "gamepadA"
            },
            null
        ]
    ]
}
```

#### Modèle 2. Un contrôle aligné sur la position 12 heures de la roue

<img src="https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/reference/game-streaming-touch-control-images-wheel-outer-12-oclock.png?fit=max&auto=format&n=gzrdvT5kpqAXKEQt&q=85&s=d5088941bc9b17782fca865b3fefdc52" alt="Un contrôle aligné sur la position 12 heures de la roue" width="360" height="360" data-path="images/gdk/reference/game-streaming-touch-control-images-wheel-outer-12-oclock.png" />

```JSON theme={null}
{
   "outer": [
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        [
            null,
            {
                "type": "button",
                "action": "gamepadA"
            },
            null
        ]
    ]
}
```

#### Modèle 3 : Trois contrôles dans un groupe

L'utilisation de trois contrôles dans un groupe est un bon moyen d'ajouter des contrôles supplémentaires une fois que tous les emplacements extérieurs sont utilisés. Cela fonctionne mieux dans le cinquième emplacement du côté droit.

<img src="https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/reference/game-streaming-touch-control-images-wheel-outer-three-cluster.png?fit=max&auto=format&n=gzrdvT5kpqAXKEQt&q=85&s=f0ffb47c716e73d3e67e9951d2edbfc3" alt="Trois contrôles dans un groupe" width="360" height="360" data-path="images/gdk/reference/game-streaming-touch-control-images-wheel-outer-three-cluster.png" />

```JSON theme={null}
{
    "outer": [
        null,
        null,
        null,
        null,
        [
            {
                "type": "button",
                "action": "gamepadA"
            },
            {
                "type": "button",
                "action": "gamepadB"
            },
            {
                "type": "button",
                "action": "gamepadX"
            }
        ]
    ]
}
```

#### Modèle 4. Quatre contrôles dans un groupe

Si vous avez besoin d'un contrôle supplémentaire dans le groupe de trois, utilisez quatre contrôles dans l'emplacement. Cela fonctionne mieux dans le cinquième emplacement du côté droit.

<img src="https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/reference/game-streaming-touch-control-images-wheel-outer-four-cluster.png?fit=max&auto=format&n=gzrdvT5kpqAXKEQt&q=85&s=f20d54b951451e3e041db9fc06118784" alt="Quatre contrôles dans un groupe" width="360" height="360" data-path="images/gdk/reference/game-streaming-touch-control-images-wheel-outer-four-cluster.png" />

```JSON theme={null}
{
    "outer": [
        [
            null,
            null,
            null,
            null,
            ,
            {
                "type": "button",
                "action": "gamepadA"
            },
            {
                "type": "button",
                "action": "gamepadB"
            },
            {
                "type": "button",
                "action": "gamepadX"
            },
            {
                "type": "button",
                "action": "gamepadY"
            }
        ]
    ]
}
```


## Related topics

- [Configurer votre organisation dans Partner Center](/fr-CA/home/onboarding-access/setup-organization.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)
- [Diseño de controles táctiles de plataformas 2D](/es/build/core-features/common/game-streaming/building-touch-layouts/samples/game-streaming-touch-tak-sample-platformer.md)