【Godot】关于游戏手柄输入

（原文写于2021年国庆左右）
现在主流的游戏手柄分为任天堂、XBOX和SONY三种。三种游戏手柄键位名称和布局不一样，在Godot对应的常数名和值也不一样。
我一直以来都是PC玩家，成为Steam玩家也就两年左右，没有任何游戏主机和掌机。所以对游戏手柄也是个门外汉。2021年国庆左右购买了一款北通的宙斯手柄，这是一款与XBOX手柄键位一致的手柄。
买它的原因一个是拿来玩一些Steam上支持手柄的一些游戏，还有一个原因当然就是拿来研究Godot。

手柄是U口连接，有专用设置程序，这些都不讲了，简单讲一下在Godot中的一些测试和总结。

游戏手柄是否过时？

现在可能手机游戏的用户比较庞大，但是笔者偏偏是个不喜欢手游的人，并且坚信有些游戏就适合鼠标键盘玩，比如模拟经营类，而另一些非常适合游戏手柄玩，比如横版类和2D俯视角、2.5D动作类。
电脑+手柄其实是一个非常好的游戏娱乐组合，比键盘鼠标有趣，比触摸屏搓玻璃更优雅。

基础测试

因为Godot的官方文档没有涉及手柄的内容，API里面也是语焉不详，所以好的办法就是自己测试和总结。下面就是我当时首先写的测试代码，用于输出手柄按键对应的button_index和两个摇杆所谓“轴”和“轴上的值”。

func _input(event):
	# 输出手柄按键对应的常量值
	if event is InputEventJoypadButton and event.is_pressed():
		print(event.button_index)
	# 输出按键的轴和压力值
	if event is InputEventJoypadMotion:
		print("轴：",event.axis,"压力",event.axis_value)

以上代码会在场景运行后，自动检测并输出手柄按键对应的button_index值(枚举常量)，以及两个摇杆的横向轴和纵向对应的button_index值(枚举常量)以及两个轴向的按压值或叫偏移量。
其中：

• InputEventJoypadButton对应手柄上的非摇杆按键的按下与松开等事件；
• InputEventJoypadMotion对应检测手柄上两个摇杆的按压与反馈。

经过上述检测以及对应查看JoystickList枚举的值，总结XBOX类型手柄键位以及轴的对应的JoystickList枚举或的常量名如下：

也是就下表

JoystickList枚举常量	对应数值	说明
JOY_AXIS_0	0	游戏手柄左摇杆水平轴
JOY_AXIS_1	1	游戏手柄左摇杆垂直轴
JOY_AXIS_2	2	游戏手柄右摇杆水平轴
JOY_AXIS_3	3	游戏手柄右摇杆垂直轴
JOY_DPAD_UP	12	游戏手柄上方向键
JOY_DPAD_DOWN	13	游戏手柄下方向键
JOY_DPAD_LEFT	14	游戏手柄左方向键
JOY_DPAD_RIGHT	15	游戏手柄右方向键
JOY_XBOX_A	0	Xbox 游戏手柄A键
JOY_XBOX_B	1	Xbox 游戏手柄B键
JOY_XBOX_X	2	Xbox 游戏手柄X键
JOY_XBOX_Y	3	Xbox 游戏手柄Y键
JOY_L	4	游戏手柄左肩键
JOY_L2	6	游戏手柄左扳机键
JOY_R	5	游戏手柄右肩键
JOY_R2	7	游戏手柄的右扳机键

键位的意义

以上面的类XBOX手柄为例：
在很多游戏中对同一种手柄按键通常赋予不同的作用，但是又有一些约定俗成的类似设置。比如A键确认，B键返回，X键主技能，Y副技能。或者A是跳跃，B是冲刺等。
另外3D游戏中，左上角的摇杆控制移动，右下角摇杆控制视角等。
现在的游戏手柄还有左右共四个肩键，可以实现与更多键盘或鼠标按键功能的对应。

Godot中利用手柄摇杆和十字键分别进行简单的八向运动控制

extends Sprite

var dir = Vector2.ZERO # 方向向量
var dp = 5 # 单次移动距离


func _process(delta):
	dir = Vector2.ZERO
	# 手柄十字键控制上下左右移动
	if Input.is_joy_button_pressed(0,JOY_DPAD_LEFT):
		dir.x = -1
	if Input.is_joy_button_pressed(0,JOY_DPAD_RIGHT):
		dir.x = 1
	if Input.is_joy_button_pressed(0,JOY_DPAD_UP):
		dir.y = -1
	if Input.is_joy_button_pressed(0,JOY_DPAD_DOWN):
		dir.y = 1

	position += dir * dp

	# 手柄左上角摇杆控制移动
	dir.x = Input.get_joy_axis(0,JOY_AXIS_0)
	dir.y = Input.get_joy_axis(0,JOY_AXIS_1)
	position += dir * dp

其他的使用方式，你可以自行探索一下，这篇只作为是抛转引玉。