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

> Wheel

# Wheel

内側および外側の円形領域に配置された一連のタッチ コントロール。

## プロパティ

[`inner`](/ja-jp/reference/system/touchadaptationkit/layout/game-streaming-touch-inner-wheel) - *object*、*省略可*。ホイールの [inner](/ja-jp/reference/system/touchadaptationkit/layout/game-streaming-touch-inner-wheel) 部分に配置される最大 4 つのコントロール。

`outer` - *array*、*省略可*。`wheel` によって表される円形領域の内側領域の周囲に配置される、コントロールおよび/または [control cluster](/ja-jp/reference/system/touchadaptationkit/layout/game-streaming-touch-control-cluster-outer) で埋めることができる最大 8 スロットの配列。

* `outer` エリアの最初のスロットはホイールの上部 (1 時方向あたり) から始まり、時計回りに続きます。
* スロットは `null` でスキップできます。
* [control cluster](/ja-jp/reference/system/touchadaptationkit/layout/game-streaming-touch-control-cluster-outer) は、常に 8 つの利用可能なスロットのうち 2 つを占有します。すなわち、指定されたスロットとその次のスロットです。

## 補足

> [!NOTE]
>
> `wheel` コントロールのサイズと回転はプレイヤーが調整できます。好みに合わせてカスタマイズする際、プレイヤーはホイールのサイズと回転の両方を変更できます。

![プレイヤーによるホイールのカスタマイズ](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/reference/game-streaming-touch-control-images-wheel-ergo.jpg?fit=max\&auto=format\&n=gzrdvT5kpqAXKEQt\&q=85\&s=5667dfc8d7806d65a78055f5882ae16b)

**ヒント**

* [`inner`](/ja-jp/reference/system/touchadaptationkit/layout/game-streaming-touch-inner-wheel) 領域は、その手にとってプレイヤーが最もアクセスしやすいコントロールを配置するために使用する必要があります。
* 左側の `inner` スロットは、プレイヤーの主要な移動コントロールに使用してください。
* プレイヤーが手を動かして届かせる必要のある `outer` スロットは、頻繁にアクセスしないコマンドに使用してください。

## サンプル

##### 例 1: 中央にジョイスティック、各 outer スロットにカスタム ボタンを持つサンプル ホイール

![inner スロットにジョイスティック、各 outer スロットにカスタム ボタンを持つホイール](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/reference/game-streaming-touch-control-images-wheel-example.png?fit=max\&auto=format\&n=gzrdvT5kpqAXKEQt\&q=85\&s=599295a273b9d668d862d2d7b4c0e7c3)

```JSON theme={null}
"left": {
    "inner": [
        {
            "type": "joystick",
            "axis": {
                "input": "axisXY",
                "output": "leftJoystick",
                "deadzone": {
                    "threshold": 0.05,
                    "radial": true
                }
            }
        }
    ],
    "outer" : [
        {
            "type": "button",
            "action": "gamepadX",
            "styles": {
                "default" : {
                    "faceImage" : {
                        "type": "asset",
                        "value": "one"
                    },
                    "background" : {
                        "type": "color",
                        "value": "#80808080"
                    }
                }
            }
        },
        {
            "type": "button",
            "action": "gamepadX",
            "styles": {
                "default" : {
                    "faceImage" : {
                        "type": "asset",
                        "value": "two"
                    },
                    "background" : {
                        "type": "color",
                        "value": "#80808080"
                    }
                }
            }
        },
        {
            "type": "button",
            "action": "gamepadX",
            "styles": {
                "default" : {
                    "faceImage" : {
                        "type": "asset",
                        "value": "three"
                    },
                    "background" : {
                        "type": "color",
                        "value": "#80808080"
                    }
                }
            }
        },
        {
            "type": "button",
            "action": "gamepadX",
            "styles": {
                "default" : {
                    "faceImage" : {
                        "type": "asset",
                        "value": "four"
                    },
                    "background" : {
                        "type": "color",
                        "value": "#80808080"
                    }
                }
            }
        },
        {
            "type": "button",
            "action": "gamepadX",
            "styles": {
                "default" : {
                    "faceImage" : {
                        "type": "asset",
                        "value": "five"
                    },
                    "background" : {
                        "type": "color",
                        "value": "#80808080"
                    }
                }
            }
        },
        {
            "type": "button",
            "action": "gamepadX",
            "styles": {
                "default" : {
                    "faceImage" : {
                        "type": "asset",
                        "value": "six"
                    },
                    "background" : {
                        "type": "color",
                        "value": "#80808080"
                    }
                }
            }
        },
        {
            "type": "button",
            "action": "gamepadX",
            "styles": {
                "default" : {
                    "faceImage" : {
                        "type": "asset",
                        "value": "seven"
                    },
                    "background" : {
                        "type": "color",
                        "value": "#80808080"
                    }
                }
            }
        },
        {
            "type": "button",
            "action": "gamepadX",
            "styles": {
                "default" : {
                    "faceImage" : {
                        "type": "asset",
                        "value": "eight"
                    },
                    "background" : {
                        "type": "color",
                        "value": "#80808080"
                    }
                }
            }
        }
    ]
}
```

##### 例 2: 方向パッドとマップ ボタンを持つサンプルの left ホイール

![inner スロットにジョイスティック、各 outer スロットにカスタム ボタンを持つホイール](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/reference/game-streaming-touch-control-images-wheel-left-dpad.png?fit=max\&auto=format\&n=gzrdvT5kpqAXKEQt\&q=85\&s=d8ae823b5c086b2e1592b67595d72d62)

```JSON theme={null}
 "left": {
    "inner": [
        {
            "type": "directionalPad",
            "scale": 1.5
        }
    ],
    "outer" : [
        {
            "type": "button",
            "action": "leftBumper",
            "styles": {
                "default" : {
                    "faceImage" : {
                        "type": "icon",
                        "value": "map"
                    }
                }
            }
        },
        null,
        null,
        null,
        null,
        null,
        null
    ]
}
```

##### 例 3: 3 つのボタンを持つサンプルの right ホイール

ボタンは右手で最も届きやすい位置に配置されています。`outer` エリアのボタンは、より大きなヒット領域を持つようクラスターに配置されています。

![inner スロットにジョイスティック、各 outer スロットにカスタム ボタンを持つホイール](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/reference/game-streaming-touch-control-images-wheel-right.png?fit=max\&auto=format\&n=gzrdvT5kpqAXKEQt\&q=85\&s=ce9650dc3dafefa9a63a695f6fa5402f)

```JSON theme={null}
"right": {
    "inner": [
    {
        "type": "button",
        "action": "gamepadX",
        "styles": {
        "default": {
            "faceImage": {
            "type": "icon",
            "value": "sword"
            }
        }
        }
    }
    ],
    "outer": [
    [
        {
            "type": "button",
            "action": "gamepadB",
            "styles": {
                "default": {
                "faceImage": {
                    "type": "icon",
                    "value": "interact"
                }
                }
            }
        },
        null
    ],
    null,
    [
        {
            "type": "button",
            "action": "gamepadA",
            "styles": {
                "default": {
                "faceImage": {
                    "type": "icon",
                    "value": "jump"
                }
                }
            }
        },
        null
    ]
    ]
}

```

## 関連項目

[Touch Adaptation Kit リファレンス](/ja-jp/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-kit-overview.md)\
[Layout](/ja-jp/reference/system/touchadaptationkit/layout/game-streaming-touch-layout)


## Related topics

- [GameInputRacingWheelButtons](/reference/input/gameinput/enums/gameinputracingwheelbuttons.md)
- [GetRacingWheelState](/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getracingwheelstate.md)
- [GameInputRacingWheelAxes](/reference/input/gameinput/enums/gameinputracingwheelaxes.md)
