> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 大型電玩按鈕
> 大型電玩按鈕
# 大型電玩按鈕
大型電玩按鈕可讓您以弧形排列 6 或 8 個按鈕，呈現大型電玩機台的風格。最常用於格鬥遊戲。
## 屬性
`type` - "arcadeButtons"\
`lightKick` - *object*。輕踢的按鈕。\
`mediumKick` - *object*。中踢的按鈕。\
`heavyKick` - *object*。重踢的按鈕。\
`specialKick` - *object*、*選用*。特殊踢的按鈕。\
`lightPunch` - *object*。輕拳的按鈕。\
`mediumPunch` - *object*。中拳的按鈕。\
`heavyPunch` - *object*。重拳的按鈕。\
`specialPunch` - *object*、*選用*。特殊拳的按鈕。
上述每個物件都描述一個具有下列屬性的按鈕：
`action` - *string*。玩家觸控按鈕時要叫用的[動作](/zh-TW/reference/system/touchadaptationkit/types/game-streaming-touch-action)。
`enabled` - *boolean*、*選用*。預設為 `true`。將控制項的視覺狀態設定為啟用/停用。停用的控制項仍會接收玩家的輸入，但「不會」根據輸入變更視覺樣式。
`toggle` - *boolean*、*選用*。預設為 `false`。
* 如果為 `false`，按下按鈕時會傳送輸入，未按下時則不會傳送。
* 如果為 `true`，每次按下按鈕都會切換是否為對應的動作傳送輸入。
`visible` - *boolean*、*選用*。預設為 `true`。決定是否向玩家顯示控制項以供互動。若要在遊戲過程中變更，請參閱[使用遊戲狀態變更觸控配置](/zh-TW/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-touch-changing-layouts-game-state#change_state)。
`styles` - *object*、*選用*。自訂控制項的視覺呈現。樣式以每個可設定樣式之狀態的物件來表示。
按鈕控制項可設定下列狀態的樣式：
* `default` - 基本樣式。
* `disabled` - 控制項停用時的樣式。如果未指定，則控制項停用時，會對預設樣式套用轉換，使其呈現停用外觀。
* `idle` - 玩家「未」與控制項互動時套用。
* `activated` - 玩家觸控按鈕時套用。
**每個狀態的樣式屬性**
`opacity` - *number*、*選用*。要套用至控制項的不透明度。除了 `disabled` 以外，所有狀態的預設值皆為 1.0。
`faceImage` - *object*、*選用*。可以是[圖示](/zh-TW/reference/system/touchadaptationkit/types/game-streaming-touch-icon)或[影像資產](/zh-TW/reference/system/touchadaptationkit/types/game-streaming-touch-asset)。
`background` - *object*、*選用*。可以是[色彩](/zh-TW/reference/system/touchadaptationkit/types/game-streaming-touch-color)或[影像資產](/zh-TW/reference/system/touchadaptationkit/types/game-streaming-touch-asset)。在閒置和停用狀態下不會顯示。
**資產尺寸**
對於每個接受影像資產的樣式物件，指定的資產必須以五種 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. 大型電玩按鈕**
```JSON theme={null}
{
"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. 八個項目的大型電玩按鈕**
```JSON theme={null}
{
"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+ 起提供)
## Related topics
- [为多人游戏启用大型会话](/zh-CN/services/xbox-services/multiplayer/mpsd/concepts/live-large-sessions.md)
- [媒體驗證測試步驟](/zh-TW/publishing/game-publishing/concepts/certification/certification-media-validation-test-steps.md)
- [開發者無障礙資源](/zh-TW/build/game-principles/accessibility/accessibility-resources.md)
- [多人游戏会话高级主题](/zh-CN/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-details.md)
- [服务到服务多人游戏会话管理](/zh-CN/services/xbox-services/fundamentals/s2s-auth-calls/s2s-calls/s2s-call-patterns/live-mpsd-service-to-service.md)