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

# Touchpad

> Touchpad

# Touchpad

플레이어가 노트북 터치패드와 유사하게 상호 작용할 수 있게 해주는 아날로그 컨트롤입니다.

## Properties

`type` - "touchpad"

`axis` - *object* 또는 *array*. 이 터치패드 컨트롤의 매핑을 설명하는 단일 [axis](/ko/reference/system/touchadaptationkit/types/game-streaming-touch-axis) 또는 [axes](/ko/reference/system/touchadaptationkit/types/game-streaming-touch-axis) 배열입니다.

`action` - *object*, *optional*. 축 매핑 외에 터치 시 호출할 [action](/ko/reference/system/touchadaptationkit/types/game-streaming-touch-action)입니다.

`renderAsButton` - *boolean*, *optional*. 기본값은 `false`입니다. 터치패드를 시각적으로 버튼처럼 렌더링하려면 `true`로 설정합니다.

`enabled` - *boolean*, *optional*. 기본값은 `true`입니다. 컨트롤의 시각적 상태를 활성/비활성으로 설정합니다. 비활성화된 컨트롤은 플레이어로부터 여전히 입력을 받지만, 입력에 따라 시각적 스타일이 변경되지는 않습니다.

`visible` - *boolean*, *optional*. 기본값은 `true`입니다. 플레이어가 상호 작용할 수 있도록 컨트롤을 표시할지 여부를 결정합니다. 게임 플레이 중에 변경하려면 [게임 상태를 사용하여 터치 레이아웃 변경](/ko/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-touch-changing-layouts-game-state.md#change_state)을 참조하세요.

`styles` - *object*, *optional*. 컨트롤의 시각적 표현을 커스터마이즈합니다. 스타일은 스타일을 지정할 수 있는 상태별 오브젝트로 표현됩니다.

버튼 컨트롤은 다음 상태에 대해 스타일을 지정할 수 있습니다.

* `default` - 기본 스타일입니다.
* `disabled` - 컨트롤이 비활성화되었을 때의 스타일입니다. 지정하지 않으면 컨트롤이 비활성화되었을 때 기본 스타일에 변환이 적용되어 비활성화된 것처럼 표시됩니다.
* `idle` - 플레이어가 컨트롤과 상호 작용하지 않을 때 적용됩니다.
* `moving` - 플레이어가 컨트롤을 터치하고 있고 `action`이 정의되지 않았을 때 적용됩니다.
* `activated` - 플레이어가 컨트롤을 터치하고 있고 `action`이 정의되어 있을 때 적용됩니다.

**Styling properties per state**

`opacity` - *number*, *optional*. 컨트롤에 적용될 불투명도입니다. `disabled`를 제외한 모든 상태에서 기본값은 1.0입니다.

`background` - *object*, *optional*. [color](/ko/reference/system/touchadaptationkit/types/game-streaming-touch-color) 또는 [image asset](/ko/reference/system/touchadaptationkit/types/game-streaming-touch-asset)일 수 있습니다.

`faceImage` - *object*, *optional*. [icon](/ko/reference/system/touchadaptationkit/types/game-streaming-touch-icon) 또는 [image asset](/ko/reference/system/touchadaptationkit/types/game-streaming-touch-asset)일 수 있습니다.

**Asset dimensions**

이미지 애셋을 허용하는 각 스타일 오브젝트에 대해, 주어진 애셋은 기본 해상도와 해당 기본 해상도의 1.5x, 2.0x, 3.0x, 4.0x 배율로 제공됩니다. 주어진 이미지의 해상도는 다음 최대 해상도보다 작거나 같아야 합니다.

| Object | @1.0x | @1.5x | @2.0x | @3.0x | @4.0x |
| :- | :- | :- | :- | :- | :- |
| faceImage | 60x60 | 90x90 | 120x120 | 180x180 | 240x240 |
| background (renderAsButton = true) | 60x60 | 90x90 | 120x120 | 180x180 | 240x240 |
| background (renderAsButton = false) | 120x120 | 90x90 | 240x240 | 360x360 | 480x480 |

## Remarks

`touchpad`는 논스티키(non-sticky)이며 데드존이 없는 출력에 가장 적합합니다. 일반적으로 1인칭/3인칭 시점 게임에서 시점 카메라에 사용됩니다.

마우스 입력을 지원하는 게임의 경우, `touchpad`를 상대 마우스와 함께 사용하여 보다 정교한 시점 카메라 경험을 제공할 수 있습니다.

**Styling remarks**

`renderAsButton`이 `true`인 경우:

* `activated` 상태일 때 `faceImage`가 25% 더 작게 표시됩니다.
* 커스텀 애셋을 사용하지 않고 `gamepadX`, `gamepadY`, `gamepadA` 또는 `gamepadB` 중 하나의 액션만 갖는 버튼에 대해서는 라벨과 배경색에 대한 기본 스타일이 있습니다.

## Samples

#### Example 1: Touchpad with a look icon

**Figure 1. Touchpad Control**

![터치패드와 상호 작용하는 사용자](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/reference/game-streaming-touch-control-images-touchpad.gif?s=964c6d216b29d4d0f46f3bf0c9ae96e2)

```JSON theme={null}
{
    "type": "touchpad",
    "axis": {
        "input": "axisXY",
        "output": "rightJoystick",
        "sensitivity": 3
    },
    "styles": {
        "default" : {
            "faceImage" : {
                "type": "icon",
                "value": "look"
            }
        }
    }
}
```

#### Example 2: Touchpad with a look icon that is rendered as a button

**Figure 1. Button Touchpad Control**

![버튼으로 렌더링된 터치패드와 상호 작용하는 사용자](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/reference/game-streaming-touch-control-images-touchpad-renderAsbutton.gif?s=e803a482b67fdb7ad2eaea7608d4b0c3)

```JSON theme={null}
{
    "type": "touchpad",
    "renderAsButton": true,
    "axis": {
        "input": "axisXY",
        "output": "rightJoystick",
        "sensitivity": 3
    },
    "styles": {
        "default" : {
            "faceImage" : {
                "type": "icon",
                "value": "look"
            }
        }
    }
}
```

## Requirements

**Layout Version:** 1.0+ (Styling available from layout version 3.0+)


## Related topics

- [Touch Adaptation Kit](/reference/system/touchadaptationkit/touchadaptationkit-reference.md)
- [Templates](/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-templates.md)
- [Modelos](/pt-BR/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-templates.md)
- [Touch Adaptation Kit (TAK) Reference](/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-kit-overview.md)
- [触控适配布局的自定义资产](/zh-CN/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-custom-assets.md)