Touchpad
플레이어가 노트북 터치패드와 유사하게 상호 작용할 수 있게 해주는 아날로그 컨트롤입니다.Properties
type - “touchpad”
axis - object 또는 array. 이 터치패드 컨트롤의 매핑을 설명하는 단일 axis 또는 axes 배열입니다.
action - object, optional. 축 매핑 외에 터치 시 호출할 action입니다.
renderAsButton - boolean, optional. 기본값은 false입니다. 터치패드를 시각적으로 버튼처럼 렌더링하려면 true로 설정합니다.
enabled - boolean, optional. 기본값은 true입니다. 컨트롤의 시각적 상태를 활성/비활성으로 설정합니다. 비활성화된 컨트롤은 플레이어로부터 여전히 입력을 받지만, 입력에 따라 시각적 스타일이 변경되지는 않습니다.
visible - boolean, optional. 기본값은 true입니다. 플레이어가 상호 작용할 수 있도록 컨트롤을 표시할지 여부를 결정합니다. 게임 플레이 중에 변경하려면 게임 상태를 사용하여 터치 레이아웃 변경을 참조하세요.
styles - object, optional. 컨트롤의 시각적 표현을 커스터마이즈합니다. 스타일은 스타일을 지정할 수 있는 상태별 오브젝트로 표현됩니다.
버튼 컨트롤은 다음 상태에 대해 스타일을 지정할 수 있습니다.
default- 기본 스타일입니다.disabled- 컨트롤이 비활성화되었을 때의 스타일입니다. 지정하지 않으면 컨트롤이 비활성화되었을 때 기본 스타일에 변환이 적용되어 비활성화된 것처럼 표시됩니다.idle- 플레이어가 컨트롤과 상호 작용하지 않을 때 적용됩니다.moving- 플레이어가 컨트롤을 터치하고 있고action이 정의되지 않았을 때 적용됩니다.activated- 플레이어가 컨트롤을 터치하고 있고action이 정의되어 있을 때 적용됩니다.
opacity - number, optional. 컨트롤에 적용될 불투명도입니다. disabled를 제외한 모든 상태에서 기본값은 1.0입니다.
background - object, optional. color 또는 image asset일 수 있습니다.
faceImage - object, optional. icon 또는 image asset일 수 있습니다.
Asset dimensions
이미지 애셋을 허용하는 각 스타일 오브젝트에 대해, 주어진 애셋은 기본 해상도와 해당 기본 해상도의 1.5x, 2.0x, 3.0x, 4.0x 배율로 제공됩니다. 주어진 이미지의 해상도는 다음 최대 해상도보다 작거나 같아야 합니다.
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
Example 2: Touchpad with a look icon that is rendered as a button
Figure 1. Button Touchpad Control