다음을 통해 공유


터치패드

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

속성

type - "터치패드"

axis - 개체 또는 배열입니다. 이 터치패드 컨트롤의 매핑을 설명하는 단일 또는 배열입니다.

action - 개체, 선택적. 축 매핑 외에도 터치 시 호출되는 동작입니다.

renderAsButton - 부울, 선택적. 기본값은 false입니다. 터치 패드를 단추로 시각적으로 렌더링하려면 true로 설정합니다.

enabled - 부울, 선택적. 기본값은 true입니다. 컨트롤의 시각적 상태를 사용/사용 안 함으로 설정합니다. 비활성화된 컨트롤은 여전히 플레이어로부터 입력을 받지만, 입력을 기반으로 시각적 스타일을 변경하지는 않습니다.

visible - 부울, 선택적. 기본값은 true입니다. 플레이어가 상호 작용할 수 있도록 컨트롤을 표시할지 여부를 결정합니다. 게임 플레이 중 변경하려면 게임 상태를 사용하여 터치 레이아웃 변경을 참조하세요.

styles - 개체, 선택적. 컨트롤의 시각적 표현 사용자 지정. 스타일은 스타일을 지정할 수 있는 상태별 개체로 표시됩니다.

버튼 컨트롤의 스타일은 다음과 같을 수 있습니다.

  • default - 기본 스타일입니다.
  • disabled - 컨트롤이 비활성화되었을 때의 스타일입니다. 지정하지 않으면 컨트롤이 비활성화될 때 기본 스타일에 변형이 적용되어 비활성화된 것처럼 보입니다.
  • idle - 플레이어가 컨트롤과 상호작용하지 않을 때 적용됩니다.
  • moving - 플레이어가 컨트롤을 터치할 때 action이(가) 정의되지 않은 경우에 적용됩니다.
  • activated - 플레이어가 컨트롤을 터치할 때 action이(가) 정의되지 않은 경우에 적용됩니다.

상태별 스타일링 속성

opacity - 숫자, 선택적. 컨트롤에 적용할 불투명도입니다. disabled을(를) 제외한 모든 상태에 대해 기본값은 1.0입니다.

background - 개체, 선택적. 색상 또는 이미지 자산일 수 있습니다.

faceImage - 개체, 선택적. 아이콘 또는 이미지 자산일 수 있습니다.

자산 차원

이미지 자산을 허용하는 각 스타일 개체에 대해 지정된 자산은 기본 해상도와 해당 기본 해상도의 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 = true) 120x120 90x90 240x240 360x360 480x480

비고

touchpad이(가) 일반적으로 1인칭/3인칭 큐브 뷰 게임에서 비정형, 비사용 영역 출력에 가장 적합합니다.

마우스 입력을 지원하는 게임의 경우 touchpad이(가) 상대 마우스와 함께 사용하여 더 조정된 디자인 카메라 환경을 제공할 수 있습니다.

스타일링 설명

renderAsButton이(가) true인 경우:

  • activated 상태일 때 faceImage은(는) 25% 작게 표시됩니다.
  • 사용자 지정 자산을 사용하지 않고 gamepadX, gamepadY, gamepadA 또는 gamepadB의 단일 작업이 있는 버튼의 배경색에 대한 레이블과 기본 스타일이 있습니다.

샘플

예제 1: 모양 아이콘이 있는 터치 패드

그림 1. 터치패드 컨트롤

터치 패드와 상호 작용하는 사용자

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

예제 2: 단추로 렌더링되는 모양 아이콘이 있는 터치 패드

그림 1. 단추 터치 패드 컨트롤

터치 패드를 버튼으로 사용하여 상호 작용하는 사용자

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

요구 사항

레이아웃 버전: 1.0 이상(레이아웃 버전 3.0 이상에서 스타일 지정 가능)