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

# Knob

> Knob

# Knob

可供玩家交互的、类似按钮组件的样式属性。

## 属性

`background` - *object*，*可选*。可以是 [color](/zh-CN/reference/system/touchadaptationkit/types/game-streaming-touch-color) 或 [image asset](/zh-CN/reference/system/touchadaptationkit/types/game-streaming-touch-asset)。

`faceImage` - *object*，*可选*。可以是 [icon](/zh-CN/reference/system/touchadaptationkit/types/game-streaming-touch-icon) 或 [image asset](/zh-CN/reference/system/touchadaptationkit/types/game-streaming-touch-asset)。

`opacity` - *number*，*可选*。要应用于该组件的不透明度。除 `disabled` 状态外，所有状态默认为 1.0。

[`stroke`](/zh-CN/reference/system/touchadaptationkit/types/game-streaming-touch-stroke) - *object*，*可选*。用于该组件轮廓的 [stroke](/zh-CN/reference/system/touchadaptationkit/types/game-streaming-touch-stroke) 样式设置。

## 示例

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

## 备注

`knob` 是更复杂控件（例如 [joystick](/zh-CN/reference/system/touchadaptationkit/controls/game-streaming-touch-joystick)、
[throttle](/zh-CN/reference/system/touchadaptationkit/controls/game-streaming-touch-throttle)）的一个组成部分，
可供玩家进行交互。

`knob` 的默认视觉样式因控件而异。

## 相关控件

[Joystick](/zh-CN/reference/system/touchadaptationkit/controls/game-streaming-touch-joystick)\
[Throttle](/zh-CN/reference/system/touchadaptationkit/controls/game-streaming-touch-throttle)

## 另请参阅

[Touch Adaptation Kit 参考](/zh-CN/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-kit-overview.md)


## Related topics

- [触控适配布局的自定义资产](/zh-CN/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-custom-assets.md)
- [터치 적응 레이아웃용 사용자 지정 자산](/ko/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-custom-assets.md)
- [タッチ適応レイアウト用のカスタム アセット](/ja-jp/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-custom-assets.md)
- [Touch Adaptation Kit](/reference/system/touchadaptationkit/touchadaptationkit-reference.md)
- [Touch Adaptation Kit (TAK) Reference](/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-kit-overview.md)