Attention: Here be dragons
This is the latest
(unstable) version of this documentation, which may document features
not available in or compatible with released stable versions of Godot.
Checking the stable version of the documentation...
带弹簧臂的第三人称相机
介绍
3D 游戏经常会用到第三人称相机，相机会跟随玩家角色、车辆等物体，还能够围绕目标旋转。
在 Godot 中将 Camera3D 设置为某个节点的子节点就可以实现这种相机。不过如果直接这样做、不进行额外处理，你就会发现相机会穿过几何体，导致场景被遮挡。
这就需要用到 SpringArm3D（弹簧臂）节点了。
弹簧臂是什么？
弹簧臂有两个主要组件会影响其行为。
弹簧臂的“长度”是指从弹簧臂全局位置开始检测碰撞的距离：
弹簧臂的“形状”则是用于碰撞检测的形状。弹簧臂会用这个形状从它的原点一路“扫”到长度的位置。
弹簧臂会尝试将所有子节点保持在其长度的末端。当形状与其他物体发生碰撞时，就会将子节点放置在碰撞点处或其附近：
带相机的弹簧臂
当相机作为弹簧臂的子节点放置时，会使用一个代表相机的金字塔形状作为碰撞体形状。
这个金字塔代表了摄像机的近平面：
备注
如果给弹簧臂指定了特定形状，那么该形状将始终被使用。
相机的形状仅在相机是弹簧臂的直接子节点时使用。
如果没有提供形状并且相机不是直接子节点，弹簧臂将回退使用射线检测，这对于相机碰撞来说不准确，因此不推荐使用。
每个物理处理帧中，弹簧臂都会执行一次运动投射，以检查是否发生碰撞：
当形状碰到物体时，相机将被放置在碰撞点或其附近：
设置弹簧臂和相机
让我们在平台跳跃演示项目中添加弹簧臂和相机吧。
通常，对于第三人称相机设置，在被跟随的节点下有三个子节点：
Node3D（相机的“轴心点”）
SpringArm3D
Camera3D
打开 player/player.tscn 场景。将这些节点设置为玩家节点的子节点，并为它们设置唯一的名称，以便在脚本中找到它们。请确保删除现有的相机节点！
将轴心点在 Y 轴上向上移动 2，使其不在地面上：
将弹簧臂的长度设置为 3，使其位于角色后方：
备注
将弹簧臂的 Shape 保持为 <空>。这样就会使用相机的金字塔形状。
如果你愿意，也可以尝试其他形状——球体是一个常见的选择，因为它可以沿着边缘平滑滑动。
更新 player/player.gd 的顶部代码，通过唯一名称获取相机和轴心点：
# Comment out this existing camera line.
# @onready var _camera := $Target/Camera3D as Camera3D
@onready var _camera := %Camera3D as Camera3D
@onready var _camera_pivot := %CameraPivot as Node3D
添加一个 _unhandled_input 函数来检测相机移动，然后相应地旋转轴心点：
@export_range(0.0, 1.0) var mouse_sensitivity = 0.01
@export var tilt_limit = deg_to_rad(75)
func _unhandled_input(event: InputEvent) -> void:
# Mouselook implemented using `screen_relative` for resolution-independent sensitivity.
if event is InputEventMouseMotion:
_camera_pivot.rotation.x -= event.screen_relative.y * mouse_sensitivity
# Prevent the camera from rotating too far up or down.
_camera_pivot.rotation.x = clampf(_camera_pivot.rotation.x, -tilt_limit, tilt_limit)
_camera_pivot.rotation.y += -event.screen_relative.x * mouse_sensitivity
通过旋转轴心点，弹簧臂也会旋转，从而改变相机的位置。运行游戏，你会发现移动鼠标就可以使相机围绕角色旋转。如果相机向墙壁移动，就会与墙壁发生碰撞。