大型電玩按鈕

大型電玩按鈕可讓您以弧形排列 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、選用。可以是色彩或影像資產。在閒置和停用狀態下不會顯示。 資產尺寸 對於每個接受影像資產的樣式物件，指定的資產必須以五種 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

大型電玩按鈕

大型電玩按鈕

屬性

備註

範例

範例 1：大型電玩按鈕 - 六個按鈕

範例 2：大型電玩按鈕 - 八個按鈕

需求

​大型電玩按鈕

​屬性

​備註

​範例

​範例 1：大型電玩按鈕 - 六個按鈕

​範例 2：大型電玩按鈕 - 八個按鈕

​需求

大型電玩按鈕

屬性

備註

範例

範例 1：大型電玩按鈕 - 六個按鈕

範例 2：大型電玩按鈕 - 八個按鈕

需求