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

# Control cluster

> Control cluster

# Control cluster

휠의 바깥쪽 부분에서 두 개의 슬롯을 차지할 수 있는 최대 4개의 컨트롤로 이루어진 배열입니다.

## 설명

컨트롤 클러스터는 [`wheel`](/ko/reference/system/touchadaptationkit/layout/game-streaming-touch-wheel)의 `outer` 부분에 터치 컨트롤이 표시되는 위치를 보다 세밀하게 제어하는 데 사용할 수 있습니다.

일반적인 사용 사례는 다음과 같습니다.

* 하나의 컨트롤이 [`wheel`](/ko/reference/system/touchadaptationkit/layout/game-streaming-touch-wheel)의 `outer` 슬롯 두 개를 차지하도록 설정합니다. 이는 일반적으로 `outer` 섹션의 버튼에 대해 더 큰 히트 영역을 확보하려는 경우에 사용됩니다.
* 세 개 또는 네 개의 컨트롤을 삼각형 또는 사각형 형태로 그룹화하여 `outer` 슬롯의 레이아웃 옵션을 확장합니다.

> [!WARNING]
>
> 컨트롤 클러스터를 사용하여 `wheel`의 예상 경계를 벗어날 수 있는 컨트롤 그룹을 만들 수 있습니다. 여러 개의 컨트롤을 사용할 때는 화면이 작은 장치에서 원하는 대로 동작하는지 검증하십시오.

***

**`outer wheel` 영역의 컨트롤 클러스터 패턴**

> 이미지는 안쪽 슬롯에 조이스틱을 배치하고 지정된 `outer` 레이아웃으로 휠 전체를 렌더링한 모습을 보여줍니다.

#### 패턴 1. 두 개의 outer 슬롯에 걸쳐 있는 하나의 컨트롤

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

이 예제에서는 버튼의 히트 대상 영역에 주목하세요.

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

#### 패턴 2. 휠의 12시 방향에 정렬된 하나의 컨트롤

![One control aligned to 12'oclock on the wheel](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
        ]
    ]
}
```

#### 패턴 3: 클러스터의 세 개 컨트롤

세 개의 컨트롤을 클러스터로 사용하는 것은 모든 outer 슬롯이 이미 사용된 상태에서 추가 컨트롤을 넣는 데 좋은 방법입니다. 오른손 쪽 다섯 번째 슬롯에서 가장 잘 동작합니다.

![Three controls in a cluster](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"
            }
        ]
    ]
}
```

#### 패턴 4. 클러스터의 네 개 컨트롤

세 개 클러스터에 추가 컨트롤이 필요한 경우 슬롯에 네 개의 컨트롤을 사용합니다. 오른손 쪽 다섯 번째 슬롯에서 가장 잘 동작합니다.

![Four controls in a cluster](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

- [A designer's guide to building touch controls](/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-designers-guide.md)
- [Touch Adaptation Kit (TAK) Reference](/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-kit-overview.md)
- [Touch Adaptation Kit](/reference/system/touchadaptationkit/touchadaptationkit-reference.md)
- [Guia do designer para criar controles por toque](/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](/es/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-designers-guide.md)