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

# 旋鈕

> 旋鈕

# 旋鈕

玩家可與之互動、類似按鈕之元件的樣式屬性。

## 屬性

`background` - *object*，*選用*。可以是[色彩](https://docs.xbox.com/zh-TW/reference/system/touchadaptationkit/types/game-streaming-touch-color.md)或[影像資產](https://docs.xbox.com/zh-TW/reference/system/touchadaptationkit/types/game-streaming-touch-asset.md)。

`faceImage` - *object*，*選用*。可以是[圖示](https://docs.xbox.com/zh-TW/reference/system/touchadaptationkit/types/game-streaming-touch-icon.md)或[影像資產](https://docs.xbox.com/zh-TW/reference/system/touchadaptationkit/types/game-streaming-touch-asset.md)。

`opacity` - *number*，*選用*。要套用至元件的不透明度。除了 `disabled` 以外的所有狀態預設為 1.0。

[`stroke`](https://docs.xbox.com/zh-TW/reference/system/touchadaptationkit/types/game-streaming-touch-stroke) - *object*，*選用*。用於元件外框的[筆觸](https://docs.xbox.com/zh-TW/reference/system/touchadaptationkit/types/game-streaming-touch-stroke.md)樣式指示。

## 範例

```JSON theme={null}
{
    "knob": {
        "background" : {
            "type": "color",
            "value":  "#107C10"
        },
        "faceImage" : {
            "type": "icon",
            "value": "run"
        }
    },
}
```

## 備註

`knob` 是較複雜控制項 (例如[搖桿](https://docs.xbox.com/zh-TW/reference/system/touchadaptationkit/controls/game-streaming-touch-joystick.md)、
[節流閥](https://docs.xbox.com/zh-TW/reference/system/touchadaptationkit/controls/game-streaming-touch-throttle.md)) 的元件，
玩家可與之互動。

`knob` 的預設視覺樣式依控制項而有所不同。

## 相關控制項

[搖桿](https://docs.xbox.com/zh-TW/reference/system/touchadaptationkit/controls/game-streaming-touch-joystick.md)\
[節流閥](https://docs.xbox.com/zh-TW/reference/system/touchadaptationkit/controls/game-streaming-touch-throttle.md)

## 另請參閱

[Touch Adaptation Kit 參考](https://docs.xbox.com/zh-TW/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-kit-overview.md)


## Related topics

- [油門](https://docs.xbox.com/zh-TW/reference/system/touchadaptationkit/controls/game-streaming-touch-throttle.md)
- [Touch Adaptation Kit](https://docs.xbox.com/zh-TW/reference/system/touchadaptationkit/touchadaptationkit-reference.md)
- [觸控調整套件 (TAK) 參考](https://docs.xbox.com/zh-TW/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-kit-overview.md)
- [搖桿](https://docs.xbox.com/zh-TW/reference/system/touchadaptationkit/controls/game-streaming-touch-joystick.md)