다음을 통해 공유

방향 패드

  • 아티클

항상 게임 패드 방향 패드를 매핑하는 방향 패드 컨트롤입니다.

속성

type - "directionalPad". 컨트롤 형식을 지정합니다.

scale - 숫자, 선택적. 기본값은 1입니다. 크기 승수는 방향 패드가 버튼처럼 배치되고 조이스틱처럼 자동으로 크기가 조정되지 않기 때문에 유용합니다.

deadzone - 숫자, 선택적. deadzone의 크기를 컨트롤의 백분율로 지정하는 0과 1 사이의 값입니다. 조이스틱의 deadzone과 달리 방향 패드 deadzone은 항상 축(사각형)입니다.

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

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

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

interaction - 개체, 선택적. 컨트롤을 사용하여 사용자의 작동 메커니즘을 변경할 수 있는 속성 정의

상호 작용

activationType - 문자열, 선택적. 방향 패드 작동에서 지정된 방향에 허용되는 활성화 유형을 정의합니다. 기본값은 allowNeighboring입니다. exclusive로 설정하면 방향 패드에서 한 번에 한 방향만 활성화할 수 있습니다(예: '위쪽', '오른쪽', '아래쪽' 또는 '왼쪽' 중 하나만). allowNeighboring로 설정하면 방향과 인접 방향 중 하나를 탭하여 동시에 활성화할 수 있습니다(즉, 사용자가 각 개별 방향을 활성화하는 기능 외에도 각 방향 간에 탭하여 'Up+Right', 'Right+Down', 'Down+Left' 또는 'Left+Up'을 활성화할 수 있습니다).

상태 및 스타일링 속성

방향 패드 컨트롤의 스타일은 다음과 같습니다.

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

다음 속성을 사용하여 방향 패드 컨트롤의 스타일을 지정할 수 있습니다.

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

fill - 개체, 선택적. 방향 패드가 활성화될 때 사용할 그라데이션에 정의된 색이 있는 개체입니다.

gradient - 개체, 선택적. 방향 패드가 활성화될 때 사용할 그라데이션에 정의된 색이 있는 개체입니다.

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

stroke - 개체, 선택적. 방향 패드의 윤곽선에 사용할 색입니다. 스트로크 개체여야 합니다.

자산 차원

이미지 자산을 허용하는 각 스타일 개체에 대해 지정된 자산은 기본 해상도와 해당 기본 해상도의 1.5x, 2.0x, 3.0x 및 4.0x 배율로 제공됩니다. 지정된 이미지의 해상도는 다음 최대 해상도보다 작거나 같아야 합니다.

Object @1.0x @1.5x @2.0x @3.0x @4.0x
background 75x75 112x112 150x150 225x225 300x300

비고

방향 패드는 물리적 컨트롤러의 방향 패드와 유사한 환경을 제공하는 데 사용됩니다.

플레이어의 기본 이동 메커니즘으로 사용되는 경우(일반적으로 leftinner 슬롯에서) 배율을 2로 사용하는 것이 좋습니다.

스타일링 설명

background에 대한 사용자 정의 이미지 자산을 사용하는 경우 참조되는 최대 해상도는 scale=1.0에 대한 것입니다. 다른 스케일을 사용하는 경우 최대 해상도는 해상도와 스케일의 곱과 같습니다. 예를 들어 scale=1.5는 @1.0x DPI 배경 이미지가 90x90의 최대 해상도를 가질 수 있음을 의미합니다.

Warning

콘텐츠 테스트 애플리케이션의 Windows 버전을 통해 스트리밍할 때 모든 스타일이 올바르게 표시되지는 않습니다.

샘플

예제 1: 기본 방향 패드

그림 1. 방향 패드

방향 패드와 상호 작용하는 사용자 

{
    "type": "directionalPad",
    "scale": 1.0
}

예제 2: 사용자 지정 색이 있는 더 큰 방향 패드입니다.

그림 1. 사용자 지정 방향 패드

사용자 지정 방향 패드와 상호 작용하는 사용자 

{
    "type": "directionalPad" ,
    "scale": 2.0,
    "styles" : {
        "default" : {
            "fill" : "#0e7a0d10",
            "gradient" : {
                "color": "#0e7a0d10"
            },
            "stroke" : {
                "type": "solid",
                "color" : "#0e7a0dff"
            }
        }
    }
}

요구 사항

레이아웃 버전: 1.0 이상(3.0 이상에서 스타일 지정 지원, 3.4 이상에서 상호 작용 지원)