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

ホイールの外側部分の 2 スロットを占有できる、最大 4 つのコントロールの配列。

## 補足

control cluster を使用すると、[`wheel`](/ja-jp/reference/system/touchadaptationkit/layout/game-streaming-touch-wheel) の `outer` 部分にタッチ コントロールを表示する場所を、より細かく制御できます。

一般的な用途は次のとおりです:

* 1 つのコントロールに [`wheel`](/ja-jp/reference/system/touchadaptationkit/layout/game-streaming-touch-wheel) の 2 つの `outer` スロットを占有させます。これは、`outer` セクションのボタンに対してより大きなヒット領域を持たせたい場合によく使用されます。
* 3 つまたは 4 つのコントロールを三角形または四角形の構成でグループ化して、`outer` スロットのレイアウト オプションを拡張します。

> [!WARNING]
>
> control cluster を使用して、`wheel` の想定される境界を超えて拡張する可能性のあるコントロール グループを作成することができます。複数のコントロールを使用する場合は、画面の小さいデバイスで期待どおりに動作することを検証してください。

***

**`outer wheel` 領域における control cluster のパターン**

> 画像は、inner スロットにジョイスティックが配置され、`outer` レイアウトが指定されたとおりのホイールの完全なレンダリングを示しています。

#### パターン 1. 2 つの outer スロットにまたがる 1 つのコントロール

![2 つの 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 時方向に配置された 1 つのコントロール

![ホイール上で 12 時方向に配置された 1 つのコントロール](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: クラスター内の 3 つのコントロール

3 つのコントロールをクラスターで使用することは、すべての outer スロットを利用した後に追加のコントロールを加える良い方法です。右手側の 5 番目のスロットで最適に機能します。

![クラスター内の 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. クラスター内の 4 つのコントロール

3 つのクラスターに追加のコントロールが必要な場合は、スロット内で 4 つのコントロールを使用します。右手側の 5 番目のスロットで最適に機能します。

![クラスター内の 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

- [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)