Arcade Buttons

街机按钮允许以街机机柜的风格排列一组 6 或 8 个按钮，呈弧形布局。最常用于格斗游戏。

属性

type - “arcadeButtons”
lightKick - object。轻踢按钮。
mediumKick - object。中踢按钮。
heavyKick - object。重踢按钮。
specialKick - object，可选。特殊踢按钮。
lightPunch - object。轻拳按钮。
mediumPunch - object。中拳按钮。
heavyPunch - object。重拳按钮。
specialPunch - object，可选。特殊拳按钮。上述每个对象都用以下属性描述一个按钮： action - string。玩家触摸按钮时要调用的操作。 enabled - boolean，可选。默认为 true。将控件的可视状态设置为启用/禁用。禁用的控件仍会接收玩家的输入，但不会根据输入更改其可视样式。 toggle - boolean，可选。默认为 false。

若为 false，按下按钮时发送输入，不按时不发送。
若为 true，每次按下按钮都会切换是否发送对应操作的输入。

visible - boolean，可选。默认为 true。确定该控件是否显示给玩家进行交互。要在游戏过程中更改，请参阅使用游戏状态更改触控布局。 styles - object，可选。控件视觉表示的自定义。样式表示为每个可样式化状态对应的一个对象。按钮控件可以为以下状态设置样式：

default - 基本样式。
disabled - 控件被禁用时的样式。如果未指定，控件被禁用时将对默认样式应用一个变换以使其显得已禁用。
idle - 玩家未与控件交互时应用。
activated - 玩家触摸按钮时应用。

每个状态的样式属性 opacity - number，可选。应用于控件的不透明度。除 disabled 外的所有状态默认为 1.0。 faceImage - object，可选。可以是图标或图像资源。 background - object，可选。可以是颜色或图像资源。在 idle 和 disabled 状态下不可见。 资源尺寸 对于接受图像资源的每个样式对象，给定的资源必须以五个 DPI 级别提供：@1.0x、@1.5x、@2.0x、@3.0x 和 @4.0x。给定 DPI 级别的图像分辨率必须小于或等于以下最大分辨率：

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

备注

arcadebuttons 允许你将一组按钮排列成六个或八个按钮的组合，类似于街机机柜。这已针对格斗游戏进行了优化。还有一个供玩家按下的指示器，映射为一起按下所有的拳或踢按钮。 arcadebuttons 会占用较多空间，你需要谨慎处理放置在其周围的其他控件。 样式备注 处于 activated 状态时，faceImage 显示为小 25%。对于不使用自定义资源、并且仅有单一操作 gamepadX、gamepadY、gamepadA 或 gamepadB 的按钮，其背景色具有标签和默认样式。

示例

示例 1：街机按钮 - 六个按钮

图 1. 街机按钮

{
    "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"
                }
            }
        }
    }
}

示例 2：街机按钮 - 八个按钮

图 1. 八个项目的街机按钮

{
    "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"
                }
            }
        }
    }
}

要求

布局版本： 1.0+（样式功能自布局版本 3.0+ 起可用）

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

Arcade Buttons

Arcade Buttons

属性

备注

示例

示例 1：街机按钮 - 六个按钮

示例 2：街机按钮 - 八个按钮

要求

​Arcade Buttons

​属性

​备注

​示例

​示例 1：街机按钮 - 六个按钮

​示例 2：街机按钮 - 八个按钮

​要求

Arcade Buttons

属性

备注

示例

示例 1：街机按钮 - 六个按钮

示例 2：街机按钮 - 八个按钮

要求