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

# 控制項叢集

> 控制項叢集

# 控制項叢集

最多四個控制項的陣列，可用來佔用轉盤外部的兩個位置。

## 備註

控制項叢集可讓您更精細地控制觸控控制項在 [`wheel`](https://docs.xbox.com/zh-TW/reference/system/touchadaptationkit/layout/game-streaming-touch-wheel) 的 `outer` 部分中顯示的位置。

常見用途包括：

* 讓一個控制項佔用 [`wheel`](https://docs.xbox.com/zh-TW/reference/system/touchadaptationkit/layout/game-streaming-touch-wheel) 的兩個 `outer` 位置。當您想要讓 `outer` 區段上的按鈕擁有較大的點擊區域時，通常會使用此方式。
* 藉由建立三個或四個控制項排列成三角形或方形配置的群組，擴充 `outer` 位置中的配置選項。

> [!WARNING]
>
> 使用控制項叢集時，有可能建立超出 `wheel` 預期邊界的控制項群組。使用多個控制項時，請驗證在螢幕較小的裝置上行為是否符合預期。

***

**`outer wheel` 區域中的控制項叢集模式**

> 影像顯示轉盤的完整呈現，內部位置有一個搖桿，`outer` 配置則如指定的方式。

#### 模式 1. 一個控制項橫跨兩個外部位置

![一個控制項橫跨兩個外部位置](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 點鐘方向

![一個控制項對齊轉盤上的 12 點鐘方向](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：叢集中的三個控制項

在所有外部位置都已使用後，在叢集中使用三個控制項是新增其他控制項的好方法。此方式最適合用於右手的第五個位置。

![叢集中的三個控制項](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. 叢集中的四個控制項

如果您需要在三個控制項的叢集中再新增一個控制項，請在該位置使用四個控制項。此方式最適合用於右手的第五個位置。

![叢集中的四個控制項](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

- [建置觸控控制項的設計師指南](https://docs.xbox.com/zh-TW/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-designers-guide.md)
- [滾輪](https://docs.xbox.com/zh-TW/reference/system/touchadaptationkit/layout/game-streaming-touch-wheel.md)
- [內部轉盤](https://docs.xbox.com/zh-TW/reference/system/touchadaptationkit/layout/game-streaming-touch-inner-wheel.md)
- [觸控調整套件 (TAK) 參考](https://docs.xbox.com/zh-TW/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-kit-overview.md)
- [Touch Adaptation Kit](https://docs.xbox.com/zh-TW/reference/system/touchadaptationkit/touchadaptationkit-reference.md)