Arcade Buttons

아케이드 버튼은 아케이드 게임기 스타일로 호(弧) 형태로 배치된 6개 또는 8개의 버튼 모음을 허용합니다. 격투 게임에 가장 흔히 사용됩니다.

Properties

type - “arcadeButtons”
lightKick - object. 가벼운 킥에 대한 버튼입니다.
mediumKick - object. 중간 킥에 대한 버튼입니다.
heavyKick - object. 강한 킥에 대한 버튼입니다.
specialKick - object, optional. 스페셜 킥에 대한 버튼입니다.
lightPunch - object. 가벼운 펀치에 대한 버튼입니다.
mediumPunch - object. 중간 펀치에 대한 버튼입니다.
heavyPunch - object. 강한 펀치에 대한 버튼입니다.
specialPunch - object, optional. 스페셜 펀치에 대한 버튼입니다. 위의 각 오브젝트는 다음 속성으로 버튼을 설명합니다. action - string. 플레이어가 버튼을 터치할 때 호출할 Action(s)입니다. enabled - boolean, optional. 기본값은 true입니다. 컨트롤의 시각적 상태를 활성/비활성으로 설정합니다. 비활성화된 컨트롤은 플레이어로부터 여전히 입력을 받지만, 입력에 따라 시각적 스타일이 변경되지는 않습니다. toggle - boolean, optional. 기본값은 false입니다.

false이면 버튼을 누를 때 입력이 전송되고, 누르지 않을 때는 전송되지 않습니다.
true이면 버튼을 누를 때마다 해당 액션에 대해 입력을 전송하는지 여부가 전환됩니다.

visible - boolean, optional. 기본값은 true입니다. 플레이어가 상호 작용할 수 있도록 컨트롤을 표시할지 여부를 결정합니다. 게임 플레이 중에 변경하려면 게임 상태를 사용하여 터치 레이아웃 변경을 참조하세요. styles - object, optional. 컨트롤의 시각적 표현을 커스터마이즈합니다. 스타일은 스타일을 지정할 수 있는 상태별 오브젝트로 표현됩니다. 버튼 컨트롤은 다음 상태에 대해 스타일을 지정할 수 있습니다.

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

Styling properties per state opacity - number, optional. 컨트롤에 적용될 불투명도입니다. disabled를 제외한 모든 상태에서 기본값은 1.0입니다. faceImage - object, optional. icon 또는 image asset일 수 있습니다. background - object, optional. color 또는 image asset일 수 있습니다. idle 및 disabled 상태에서는 표시되지 않습니다. Asset dimensions 이미지 애셋을 허용하는 각 스타일 오브젝트에 대해, 주어진 애셋은 @1.0x, @1.5x, @2.0x, @3.0x, @4.0x의 5가지 DPI 수준으로 제공되어야 합니다. 특정 DPI 수준의 이미지 해상도는 다음 최대 해상도보다 작거나 같아야 합니다.

Object	@1.0x	@1.5x	@2.0x	@3.0x	@4.0x
faceImage	60x60	90x90	120x120	180x180	240x240
background	60x60	90x90	120x120	180x180	240x240

Remarks

arcadebuttons를 사용하면 아케이드 게임기와 유사한 6개 또는 8개 버튼 그룹에 버튼 세트를 배치할 수 있습니다. 이는 격투 게임에 최적화되어 있습니다. 또한 모든 펀치 또는 킥 버튼을 함께 누르는 것에 매핑되는, 플레이어가 누를 수 있는 인디케이터도 있습니다. arcadebuttons는 더 많은 공간을 차지하므로 그 주위에 배치되는 다른 컨트롤에 주의해야 합니다. Styling remarks activated 상태일 때 faceImage가 25% 더 작게 표시됩니다. 커스텀 애셋을 사용하지 않고 gamepadX, gamepadY, gamepadA 또는 gamepadB 중 하나의 액션만 갖는 버튼에 대해서는 라벨과 배경색에 대한 기본 스타일이 있습니다.

Samples

Example 1: Arcade button - six buttons

Figure 1. Arcade Buttons

{
    "type": "arcadeButtons",
    "lightPunch": {
        "action": "gamepadX",
        "styles": {
            "default" : {
                "faceImage" : {
                    "type": "icon",
                    "value": "lightPunch"
                }
            }
        }
    },
    "mediumPunch": {
        "action": "gamepadY",
        "styles": {
            "default" : {
                "faceImage" : {
                    "type": "icon",
                    "value": "mediumPunch"
                }
            }
        }
    },
    "heavyPunch": {
        "action": "rightBumper",
        "styles": {
            "default" : {
                "faceImage" : {
                    "type": "icon",
                    "value": "heavyPunch"
                }
            }
        }
    },
    "lightKick": {
        "action": "gamepadA",
        "styles": {
            "default" : {
                "faceImage" : {
                    "type": "icon",
                    "value": "lightKick"
                }
            }
        }
    },
    "mediumKick": {
        "action": "gamepadB",
        "styles": {
            "default" : {
                "faceImage" : {
                    "type": "icon",
                    "value": "mediumKick"
                }
            }
        }
    },
    "heavyKick": {
        "action": "leftBumper",
        "styles": {
            "default" : {
                "faceImage" : {
                    "type": "icon",
                    "value": "heavyKick"
                }
            }
        }
    }
}

Example 2: Arcade button - eight buttons

Figure 1. Eight Item Arcade Buttons

{
    "type": "arcadeButtons",
    "lightPunch": {
        "action": "gamepadX",
        "styles": {
            "default" : {
                "faceImage" : {
                    "type": "icon",
                    "value": "lightPunch"
                }
            }
        }
    },
    "mediumPunch": {
        "action": "gamepadY",
        "styles": {
            "default" : {
                "faceImage" : {
                    "type": "icon",
                    "value": "mediumPunch"
                }
            }
        }
    },
    "heavyPunch": {
        "action": "rightBumper",
        "styles": {
            "default" : {
                "faceImage" : {
                    "type": "icon",
                    "value": "heavyPunch"
                }
            }
        }
    },
    "specialPunch": {
        "action": "rightTrigger",
        "styles": {
            "default" : {
                "faceImage" : {
                    "type": "icon",
                    "value": "heavyPunch2"
                }
            }
        }
    },
    "lightKick": {
        "action": "gamepadA",
        "styles": {
            "default" : {
                "faceImage" : {
                    "type": "icon",
                    "value": "lightKick"
                }
            }
        }
    },
    "mediumKick": {
        "action": "gamepadB",
        "styles": {
            "default" : {
                "faceImage" : {
                    "type": "icon",
                    "value": "mediumKick"
                }
            }
        }
    },
    "heavyKick": {
        "action": "rightTrigger",
        "styles": {
            "default" : {
                "faceImage" : {
                    "type": "icon",
                    "value": "heavyKick"
                }
            }
        }
    },
    "specialKick": {
        "action": "leftBumper",
        "styles": {
            "default" : {
                "faceImage" : {
                    "type": "icon",
                    "value": "heavyKick2"
                }
            }
        }
    }
}

Requirements

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

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

Arcade Buttons

Arcade Buttons

Properties

Remarks

Samples

Example 1: Arcade button - six buttons

Example 2: Arcade button - eight buttons

Requirements

​Arcade Buttons

​Properties

​Remarks

​Samples

​Example 1: Arcade button - six buttons

​Example 2: Arcade button - eight buttons

​Requirements

Arcade Buttons

Properties

Remarks

Samples

Example 1: Arcade button - six buttons

Example 2: Arcade button - eight buttons

Requirements