Arcade 按钮

项目
07/31/2024

Arcade 按钮可以提供一组按圆弧状排列的 6 或 8 个按钮，其样式为 Arcade 机柜风格。最常运用于格斗游戏。

属性

type - "arcadeButtons"
lightKick - 对象。小踢动作按钮。
mediumKick - 对象。中踢动作按钮。
heavyKick - 对象。大踢动作按钮。
specialKick - 对象，可选。技能踢动作按钮。
lightPunch - 对象。小拳动作按钮。
mediumPunch - 对象。中拳动作按钮。
heavyPunch - 对象。大拳动作按钮。
specialPunch - 对象，可选。技能拳动作按钮。

以上每个对象都描述了一个具有以下属性的按钮：

action - 字符串。将在玩家触摸按钮时调用的操作。

enabled - 布尔，可选。默认为 true。将控件的可视状态设置为已启用/禁用。禁用的控件仍将接收玩家的输入，但不会根据输入更改视觉样式。

toggle - 布尔，可选。默认为 false。

如果是 false，按下按钮时将发送该按钮的输入，不按则不发送。
如果是 true，则每次按下按钮都将切换是否发送对应操作的输入。

visible - 布尔，可选。默认为 true。确定控件是否显示给玩家进行交互。若要在游戏期间进行更改，请参阅 [使用游戏状态更改触摸布局（game-streaming-touch-change-layouts-game-state.md#change_state）。

styles - 对象，可选。自定义控件的可视化表示形式。样式表示为每个可以设置样式的状态的对象。

按钮控件可以具有以下样式状态：

default - 基本样式。
disabled - 禁用控件时的样式。如果未指定，则禁用控件时，将对默认样式应用转换，使其显示为禁用。
idle - 在玩家未与控件交互时应用。
activated - 在玩家触摸按钮时应用。

每个状态的样式属性

opacity - 数字，可选。要应用于控件的不透明度。对于除 disabled 之外的所有状态默认为 1.0。

faceImage - 对象，可选。可以是图标或图像资产。

background - 对象，可选。可以是颜色或图像资产。在空闲和禁用状态下不可见。

资产维度

对于接受图像资产的每个样式对象，必须以五个 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：Arcade 按钮 - 六个按钮

图 1. Arcade 按钮

用户与包含六个项目的街机按钮交互

{
    "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：Arcade 按钮 - 八个按钮

图 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+ 开始提供样式）

通过

Arcade 按钮

属性

备注

示例

示例 1：Arcade 按钮 - 六个按钮

示例 2：Arcade 按钮 - 八个按钮

要求

其他资源