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

# 控制項叢集

> 控制項叢集

# 控制項叢集

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

## 備註

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

常見用途包括：

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

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

***

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

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

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

<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="一個控制項橫跨兩個外部位置" width="400" height="400" data-path="images/gdk/reference/game-streaming-touch-control-images-wheel-outer-span-two-slots.gif" />

在此範例中，請注意按鈕的點擊目標區域。

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

#### 模式 2. 一個控制項對齊轉盤上的 12 點鐘方向

<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="一個控制項對齊轉盤上的 12 點鐘方向" 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
        ]
    ]
}
```

#### 模式 3：叢集中的三個控制項

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

<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="叢集中的三個控制項" 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"
            }
        ]
    ]
}
```

#### 模式 4. 叢集中的四個控制項

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

<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="叢集中的四個控制項" 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

- [PlayFab Party 版本資訊](/zh-TW/services/playfab/multiplayer/networking/release-notes.md)
- [XBOX 主機遊戲的認證測試 XBOX 需求](/zh-TW/publishing/certification/console-cert-tested-requirements.md)
- [XR-003 提交的遊戲品質](/zh-TW/publishing/certification/xr/xr-003.md)
- [XBOX 遊戲的 XBOX 需求](/zh-TW/publishing/certification/xbox-requirements.md)
- [标准 XBOX 控制器触控控制布局](/zh-CN/build/core-features/common/game-streaming/building-touch-layouts/samples/game-streaming-touch-tak-sample-full-layout.md)
