游戏引擎 / 系统课时
驱动角色胶囊体移动
驱动角色胶囊体移动
把 Player/Move 的二维输入转换成胶囊体的三维位移,并用相机朝向决定前进方向。移动组件负责平滑加减速、转向、重力与碰撞,完成后可在平地、墙边及不同宽度的通道中验证,不依赖刚体推动角色。
学习目标
- 配置尺寸合理的
CharacterController,让Move负责角色碰撞位移。 - 在
Update中读取输入、计算相机相对方向与逐帧速度。 - 用速度、墙面接触和通道净宽三类指标检验移动效果。
配好胶囊体与输入
以 Unity 6(6000.x)和 Input System 1.x 为例。先在 Window > Package Management > Package Manager 安装 Input System,并确认 Edit > Project Settings > Player > Other Settings > Active Input Handling 包含 Input System Package (New);如编辑器提示重启,按提示操作。
- 新建空对象
Player,位置设为(0, 0, 0),添加Character Controller和Player Input。可在子物体放胶囊网格作外观,将子物体局部位置设为(0, 0.9, 0)、缩放设为(0.7, 0.9, 0.7),再删除自动附带的Capsule Collider;根物体不要添加Rigidbody。 - 在 Input Actions 资源中创建
PlayerAction Map 和MoveAction,设为Action Type = Value、Control Type = Vector2。为Move添加2D Vector复合绑定(W/A/S/D)及<Gamepad>/leftStick。 - 在
Player Input的Actions字段引用该资源,Default Action Map(部分版本显示为Default Map)选择Player。到Edit > Project Settings > Input System Package > Input Settings将Update Mode保持为Process Events In Dynamic Update,以便在Update中读取当帧输入。 - 摄像机保持独立跟随,不要把它挂在会随方向旋转的玩家根物体下;稍后将摄像机 Transform 拖到脚本的
View Camera字段。
在 Character Controller 检查以下起步值,单位按 Unity 场景中的 1 单位约等于 1 米理解:
| 属性 | 起步值 | 检查目的 |
|---|---|---|
| Height / Radius | 1.8 / 0.35 |
胶囊直径为 0.70 m |
| Center | (0, 0.9, 0) |
根节点落在脚底附近 |
| Slope Limit / Step Offset | 45° / 0.3 |
控制可行坡角与可跨台阶 |
| Skin Width | 0.04 |
避免皮肤宽度过小引发卡顿 |
| Min Move Distance | 0 |
不丢弃低速的小位移 |
地板和墙面必须有非 Trigger 的碰撞体(例如 Box Collider);CharacterController 本身不需要另配 Capsule Collider。
用 Move 驱动平滑运动
创建 Assets/Scripts/Runtime/CapsuleMotor.cs,将以下完整脚本挂到 Player,再指定 View Camera。如果没有手动指定,脚本会尝试使用标记为 MainCamera 的摄像机;仍未找到时退回世界坐标前方。
using UnityEngine;
using UnityEngine.InputSystem;
[RequireComponent(typeof(CharacterController), typeof(PlayerInput))]
public sealed class CapsuleMotor : MonoBehaviour
{
[SerializeField] private Transform viewCamera;
[SerializeField, Min(0f)] private float moveSpeed = 5f;
[SerializeField, Min(0f)] private float acceleration = 18f;
[SerializeField, Min(0f)] private float deceleration = 24f;
[SerializeField, Min(0f)] private float turnRate = 540f;
[SerializeField] private float gravity = -20f;
private CharacterController controller;
private PlayerInput playerInput;
private InputAction moveAction;
private Vector3 planarVelocity;
private float verticalSpeed;
private void Awake()
{
controller = GetComponent<CharacterController>();
playerInput = GetComponent<PlayerInput>();
}
private void Start()
{
// 读取当前 PlayerInput 持有的动作,而非全局动作副本。
moveAction = playerInput.actions.FindAction("Player/Move", true);
if (viewCamera == null && Camera.main != null)
viewCamera = Camera.main.transform;
}
private void Update()
{
float dt = Time.deltaTime;
if (dt <= 0f) return;
// 限制斜向输入,避免 W+D 比单按 W 跑得更快。
Vector2 input = Vector2.ClampMagnitude(moveAction.ReadValue<Vector2>(), 1f);
Vector3 forward = viewCamera != null ? viewCamera.forward : Vector3.forward;
forward.y = 0f;
if (forward.sqrMagnitude < 0.0001f) forward = Vector3.forward;
forward.Normalize();
Vector3 right = Vector3.Cross(Vector3.up, forward);
Vector3 direction = forward * input.y + right * input.x;
// 速度以 m/s 保存;加减速度以 m/s² 乘以帧时长。
Vector3 target = direction * moveSpeed;
float rate = input.sqrMagnitude > 0.0001f ? acceleration : deceleration;
planarVelocity = Vector3.MoveTowards(planarVelocity, target, rate * dt);
if (direction.sqrMagnitude > 0.0001f)
{
Quaternion facing = Quaternion.LookRotation(direction);
transform.rotation = Quaternion.RotateTowards(transform.rotation, facing, turnRate * dt);
}
// Move 不会自动施加重力;少量向下速度用于保持接地。
if (controller.isGrounded && verticalSpeed < 0f)
verticalSpeed = -2f;
verticalSpeed += gravity * dt;
Vector3 delta = (planarVelocity + Vector3.up * verticalSpeed) * dt;
CollisionFlags flags = controller.Move(delta);
if ((flags & CollisionFlags.Below) != 0 && verticalSpeed < 0f)
verticalSpeed = -2f;
if ((flags & CollisionFlags.Above) != 0 && verticalSpeed > 0f)
verticalSpeed = 0f;
}
}预期结果:进入 Play 模式后,按 W/S/A/D 可相对于摄像机前进、后退或横移;方向变化时逐渐转身,松开后短暂减速至停下,触墙不能穿透。脚本没有打印日志,验收以 Game 视图中的移动表现为准。
看懂每帧的移动与接触
输入只给出 Vector2 意图;将摄像机 forward 投影到水平面,再用 Cross(up, forward) 求右向,可避免镜头俯仰让玩家向地下移动。之后用 Vector3.MoveTowards 将水平速度逼近目标速度,最后叠加手动计算的竖直速度。CharacterController.Move(delta) 的参数是本帧位移(米),不是速度(米/秒),因此只在调用前乘一次 Time.deltaTime。

例如从静止全速前进,moveSpeed = 5 m/s、acceleration = 18 m/s²,约 0.28 s 达到最高速;松开后以 24 m/s² 减速,约 0.21 s 停止,实际位置会随帧时长略有差异。controller.isGrounded 代表上一次 Move 后的接地状态,而本次 Move 返回的 CollisionFlags 可以同时含有 Below 和 Sides;检查某种接触应使用位掩码,而不能简单判断二者是否完全相等。
此处选择在 Update 内读取输入并调用一次 Move,适合不通过刚体模拟位移的 CharacterController。不要再在 FixedUpdate 中重复移动,也不要同时用 transform.position 或动画根运动覆盖位置。接口行为可对照 Unity 官方 CharacterController.Move 文档。
在三种障碍场景里验收
在平面地板上放置有 Box Collider 的墙体,墙体高度设为 2 m,通道宽度从两侧墙体碰撞面的内边缘量取。先确保摄像机正前方没有障碍,随后做以下测试:
| 场景 | 操作与尺寸 | 应观察到的行为 |
|---|---|---|
| 平地 | 从静止按住 W 1 s,再松开 |
约 0.28 s 加速至 5 m/s,首秒位移约 4.3 m;松开后约 0.21 s 停止 |
| 墙边 | 斜向靠近一段长墙,保持沿墙的输入分量 | 沿墙面滑动、不穿墙;接触时可在调试器里看到 Sides 标志 |
| 狭窄通道 | 分别设置 0.65 m、0.90 m 的净宽,正对通道中心前进 |
直径 0.70 m 的胶囊无法通过 0.65 m;对齐后可通过 0.90 m |

如果角色在墙边完全停住,先确认按键方向是否仍有沿墙的切向分量;正对墙面输入时,停止是正确结果。狭道测试必须从入口中心线开始,否则即使净宽足够,转弯和入射角也会改变可通过性。
出错时按现象排查
| 现象 | 优先检查与修正 |
|---|---|
| 按键无响应 | Player Input > Actions 是否已赋资源、Default Action Map(或 Default Map)是否为 Player,以及 Player/Move 是否为 Value / Vector2;在调试器观察 input 是否变化 |
| W 的前进方向不对 | 核对 View Camera 是否引用实际游戏摄像机,且摄像机未作为会旋转的玩家根物体子对象 |
| 撞墙时穿透或抖动 | 检查墙体 Box Collider 是否启用且非 Trigger,删除额外的 Rigidbody/Capsule Collider,并关闭用于此测试的 Animator Apply Root Motion |
| 低速卡顿或通道进不去 | 确认 Min Move Distance = 0、Skin Width = 0.04,并测量墙面间真实净宽,而非模型外观或物体中心距 |
通过上述验收后,让角色位置始终由这个组件的 Move 负责;跟随摄像机可在自己的 LateUpdate 中读取玩家已更新的位置,避免输入、移动与镜头互相覆盖。