方向盘

一组在内部和外部圆形区域中排列的触模控件。

属性

inner - 对象可选。 最多 4 个控件,排列在方向盘的内部

outer - 数组可选。 一个由最多 8 个槽组成的数组,可由控件和/或控件群集填充,它们放在 wheel 表示的圆形区域的内部区域周围。

  • outer 区域中的第一个槽起点在方向盘的顶部(约 1 点钟的位置),沿着顺时针继续。
  • 可使用 null 跳过某个槽。
  • 有 8 个槽可用,一个控件群集始终占据其中 2 个槽:分别是指定它的槽和后面的那个槽。

备注

注意

玩家可调整 wheel 控件的大小和旋转度。 当玩家按照自己的首选项自定义时,他们既可更改方向盘的大小,也可更改其旋转度。

由玩家自定义方向盘

提示

  • inner 区域应该用于放置使用这只手的玩家最易触摸到的控件。
  • 左侧的 inner 槽应用于主玩家移动控件。
  • 需要玩家移动手才能触摸到的 outer 槽应用于经常访问的命令。

示例

示例 1:一个示例方向盘,它中间有一个游戏杆,每个外侧槽中有一个自定义按钮

内侧槽中有游戏杆,并且每个外侧槽中有自定义按钮的方向盘

"left": {
    "inner": [
        {
            "type": "joystick",
            "axis": {
                "input": "axisXY",
                "output": "leftJoystick",
                "deadzone": {
                    "threshold": 0.05,
                    "radial": true
                }
            }
        }
    ],
    "outer" : [
        {
            "type": "button",
            "action": "gamepadX",
            "styles": {
                "default" : {
                    "faceImage" : {
                        "type": "asset",
                        "value": "one"
                    },
                    "background" : {
                        "type": "color",
                        "value": "#80808080"
                    }
                }
            }
        },
        {
            "type": "button",
            "action": "gamepadX",
            "styles": {
                "default" : {
                    "faceImage" : {
                        "type": "asset",
                        "value": "two"
                    },
                    "background" : {
                        "type": "color",
                        "value": "#80808080"
                    }
                }
            }
        },
        {
            "type": "button",
            "action": "gamepadX",
            "styles": {
                "default" : {
                    "faceImage" : {
                        "type": "asset",
                        "value": "three"
                    },
                    "background" : {
                        "type": "color",
                        "value": "#80808080"
                    }
                }
            }
        },
        {
            "type": "button",
            "action": "gamepadX",
            "styles": {
                "default" : {
                    "faceImage" : {
                        "type": "asset",
                        "value": "four"
                    },
                    "background" : {
                        "type": "color",
                        "value": "#80808080"
                    }
                }
            }
        },
        {
            "type": "button",
            "action": "gamepadX",
            "styles": {
                "default" : {
                    "faceImage" : {
                        "type": "asset",
                        "value": "five"
                    },
                    "background" : {
                        "type": "color",
                        "value": "#80808080"
                    }
                }
            }
        },
        {
            "type": "button",
            "action": "gamepadX",
            "styles": {
                "default" : {
                    "faceImage" : {
                        "type": "asset",
                        "value": "six"
                    },
                    "background" : {
                        "type": "color",
                        "value": "#80808080"
                    }
                }
            }
        },
        {
            "type": "button",
            "action": "gamepadX",
            "styles": {
                "default" : {
                    "faceImage" : {
                        "type": "asset",
                        "value": "seven"
                    },
                    "background" : {
                        "type": "color",
                        "value": "#80808080"
                    }
                }
            }
        },
        {
            "type": "button",
            "action": "gamepadX",
            "styles": {
                "default" : {
                    "faceImage" : {
                        "type": "asset",
                        "value": "eight"
                    },
                    "background" : {
                        "type": "color",
                        "value": "#80808080"
                    }
                }
            }
        }
    ]
}
示例 2:一个示例方向盘,它有一个方向键和地图按钮

内侧槽中有游戏杆,并且每个外侧槽中有自定义按钮的方向盘

 "left": {
    "inner": [
        {
            "type": "directionalPad",
            "scale": 1.5
        }
    ],
    "outer" : [
        {
            "type": "button",
            "action": "leftBumper",
            "styles": {
                "default" : {
                    "faceImage" : {
                        "type": "icon",
                        "value": "map"
                    }
                }
            }
        },
        null,
        null,
        null,
        null,
        null,
        null
    ]
}
示例 3:一个带有 3 个按钮的示例右手方向盘

这些按钮放在右侧最容易触摸到的位置。 outer 区域中的按钮成簇排列,有一个较大的点按区域。

内侧槽中有游戏杆,并且每个外侧槽中有自定义按钮的方向盘

"right": {
    "inner": [
    {
        "type": "button",
        "action": "gamepadX",
        "styles": {
        "default": {
            "faceImage": {
            "type": "icon",
            "value": "sword"
            }
        }
        }
    }
    ],
    "outer": [
    [
        {
            "type": "button",
            "action": "gamepadB",
            "styles": {
                "default": {
                "faceImage": {
                    "type": "icon",
                    "value": "interact"
                }
                }
            }
        },
        null
    ],
    null,
    [
        {
            "type": "button",
            "action": "gamepadA",
            "styles": {
                "default": {
                "faceImage": {
                    "type": "icon",
                    "value": "jump"
                }
                }
            }
        },
        null
    ]
    ]
}

另请参阅

触控适配工具包参考
Layout