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

# Clúster de controles

> Clúster de controles

# Clúster de controles

Una matriz de hasta cuatro controles que se puede usar para ocupar dos ranuras en la parte externa de la rueda.

## Comentarios

El clúster de controles se puede usar para tener un control más preciso sobre dónde se mostrarán los controles táctiles en la parte `outer` de la [`wheel`](https://devdocs.xbox.com/es/reference/system/touchadaptationkit/layout/game-streaming-touch-wheel).

Los usos comunes incluyen:

* Hacer que un control ocupe dos ranuras `outer` de una [`wheel`](https://devdocs.xbox.com/es/reference/system/touchadaptationkit/layout/game-streaming-touch-wheel). Esto se usa habitualmente cuando desea tener un área de contacto más grande para un botón en la sección `outer`.
* Ampliar las opciones de diseño en las ranuras `outer` mediante la creación de agrupaciones de tres o cuatro controles en una configuración de triángulo o cuadrado.

> [!WARNING]
>
> Es posible usar clústeres de controles para crear agrupaciones de controles que pueden extenderse más allá de los límites esperados de la `wheel`. Cuando use varios controles, valide que el comportamiento sea el deseado en dispositivos con pantallas más pequeñas.

***

**Patrones para el clúster de controles en el área de la `outer wheel`**

> Las imágenes muestran la representación completa de la rueda con un joystick en la ranura interna y el diseño `outer` según lo especificado.

#### Patrón 1. Un control que abarca dos ranuras externas

![Un control que abarca dos ranuras externas](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/reference/game-streaming-touch-control-images-wheel-outer-span-two-slots.gif?s=578fa354436743f76172825454a4e17c)

En este ejemplo, observe el área de destino de contacto del botón.

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

#### Patrón 2. Un control alineado a las 12 en punto en la rueda

![Un control alineado a las 12 en punto en la rueda](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)

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

#### Patrón 3: Tres controles en un clúster

Usar tres controles en un clúster es una buena manera de agregar controles adicionales una vez que se han utilizado todas las ranuras externas. Funciona mejor en la quinta ranura de la mano derecha.

![Tres controles en un clúster](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)

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

#### Patrón 4. Cuatro controles en un clúster

Si necesita un control adicional en el clúster de tres, use cuatro controles en la ranura. Funciona mejor en la quinta ranura de la mano derecha.

![Cuatro controles en un clúster](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)

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

- [Guia do designer para criar controles por toque](https://devdocs.xbox.com/pt-BR/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-designers-guide.md)
- [Guía del diseñador para crear controles táctiles](https://devdocs.xbox.com/es/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-designers-guide.md)
- [Referencia del kit de adaptación táctil (TAK)](https://devdocs.xbox.com/es/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-kit-overview.md)
- [Referência do Touch Adaptation Kit (TAK)](https://devdocs.xbox.com/pt-BR/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-kit-overview.md)
- [Touch Adaptation Kit](https://devdocs.xbox.com/pt-BR/reference/system/touchadaptationkit/touchadaptationkit-reference.md)