当前位置：首页 > news >正文

Godot引擎 4.0 文档 - 循序渐进教程 - 监听玩家输入

news 2025/7/1 5:30:16

本文为Google Translate英译中结果，DrGraph在此基础上加了一些校正。英文原版页面：

Listening to player input — Godot Engine (stable) documentation in English

监听玩家输入¶

在上一课创建您的第一个脚本的基础上，让我们看看任何游戏的另一个重要特征：将控制权交给玩家。要添加它，我们需要修改我们的sprite_2d.gd代码。

您有两个主要工具来处理玩家在 Godot 中的输入：

内置的输入回调，主要是_unhandled_input(). 就像 _process()，它是一个内置的虚函数，每当玩家按下一个键时，Godot 就会调用它。这是您想要用来对并非每一帧都发生的事件做出反应的工具，例如按下Space【空格键】跳跃。要了解有关输入回调的更多信息，请参阅使用 InputEvent。
Input【单例singleton】。单例是一个全局可访问的对象。Godot 提供对多个脚本的访问。这是检查每一帧输入的正确工具。

我们将Input在这里使用单例，因为我们需要知道玩家是否想要转动或移动每一帧。

对于转动，我们应该使用一个新变量：direction。在我们的_process() 函数中，用下面的代码替换之前内容【rotation += angular_speed * delta】

GDScript

var direction = 0
if Input.is_action_pressed("ui_left"):direction = -1
if Input.is_action_pressed("ui_right"):direction = 1rotation += angular_speed * direction * delta

我们的direction局部变量是一个因数，表示玩家想要转向的方向。值0表示玩家没有按向左或向右箭头键。值1表示玩家想要右转，-1意味着他们想要左转。

为了产生这些值，我们引入了条件判断和使用Input. 条件以GDScript 中的关键字if开始，以冒号结束。具体条件是关键字和行尾之间的表达式。

要检查此帧是否按下了某个键，我们调用Input.is_action_pressed(). 该方法采用表示输入操作的文本字符串，true 如果按下操作则返回，false否则返回。

我们上面使用的两个动作，“ui_left”和“ui_right”，在每个 Godot 项目中都是预定义的。它们分别在玩家按下键盘上的左右箭头或游戏手柄的方向键上的左右箭头时触发。

注：您可以通过转到“项目”->“项目设置”并单击“输入映射”选项卡来查看和编辑项目中的输入操作。

最后，我们用direction作为因数来更新节点的 rotation: rotation += angular_speed * direction * delta

如果您使用此代码运行场景，当您按下 Left和Right时，图标应该会旋转。

按“UP”时移动¶

要仅在按键时移动，我们需要修改计算速度的代码。用下面的代码替换var velocity开头的行。

GDScript

var velocity = Vector2.ZERO
if Input.is_action_pressed("ui_up"):velocity = Vector2.UP.rotated(rotation) * speed

velocity我们用值Vector2.ZERO初始化，这是表示长度为 0 的二维向量Vector的另一个内置类型常量。

如果玩家按下“ui_up”动作，我们就会更新速度值，使精灵向前移动。

完整脚本¶

这是完整的sprite_2d.gd文件以供参考。

GDScript

extends Sprite2Dvar speed = 400
var angular_speed = PIfunc _process(delta):var direction = 0if Input.is_action_pressed("ui_left"):direction = -1if Input.is_action_pressed("ui_right"):direction = 1rotation += angular_speed * direction * deltavar velocity = Vector2.ZEROif Input.is_action_pressed("ui_up"):velocity = Vector2.UP.rotated(rotation) * speedposition += velocity * delta

如果您运行场景，您现在应该可以使用左右箭头键旋转并按向前移动Up。