15.3 阶段 2 脚本与 gameplay 编程
本页目录
一、阶段定位
本阶段解决「让玩家真的能玩」:输入系统、状态机、碰撞触发、射线检测、对象池、寻路。阶段 0 那个能跳的方块是「演示」,本阶段做完才是「游戏」——玩家能按方向键走、空格跳、碰到金币加分、敌人 AI 会追玩家。这些能力如果用「硬编码 if-else」写,到加第三个动作时就会乱成一锅粥。
不掌握本阶段会在后面具体卡在哪:
- 用 if-else 写玩家状态(idle/run/jump/attack),加一个「翻滚」就要改 5 个地方,bug 不断。
- 不会用对象池,每发一颗子弹
Instantiate、销毁时Destroy,手机上 GC 抖动掉帧。 - 碰撞
OnCollisionEnter与OnTriggerEnter混用,穿透地面或触发不触发分不清。 - 敌人追玩家用 Transform 直接改位置,穿墙、卡墙角、绕不过障碍。
判断卡住的标志:让你画出玩家状态机的状态与转移,你只能列「idle、run、jump」三个状态,说不出「空中 → 地面」「攻击中能否取消」这些转移条件。出现任一现象,先把本阶段六个模块过一遍再进 阶段 3 图形渲染基础。
二、阶段目标与投入
| 能力目标 | 验证方式 |
|---|---|
| 能用状态机实现玩家的 idle/run/jump/attack/roll 五状态 | 切换条件清晰,无穿越状态 |
| 能用对象池管理子弹、敌人、特效 | 开枪 100 次不产生 GC 分配 |
| 能区分 OnCollisionEnter 与 OnTriggerEnter 的使用场景 | 碰撞有物理反弹,触发只做事件 |
| 能用射线做「点击地面移动」或「瞄准敌人」 | 射线命中点准确,UI 点击不穿透 |
| 能用 NavMesh 或 A* 实现敌人寻路 | 敌人绕开障碍追到玩家 |
| 能用 ScriptableObject 管理敌人配置 | 改一个数值不重编译 |
建议学时:全职 3 周(约 70–80 小时);在职每天 2 小时约 6–8 周。学时分配:状态机 25%、输入与碰撞 15%、对象池 15%、射线与检测 10%、寻路 20%、ScriptableObject 配置 15%。
三、先修自检
| 先修项 | 合格标准 | 不合格时怎么办 |
|---|---|---|
| 阶段 1 | 能跑通事件解耦与场景切换 | 回到 15.2 |
| 一门语言 | 掌握 C# 或 GDScript 的类、继承、泛型 | 用半天补语法 |
| 向量与数学 | 知道 Vector3 的加减、点积、叉积 | 模块 5.3 会带实验 |
| 协程直觉 | 理解「暂停等待」的概念 | 模块 5.5 会讲 |
四、知识地图
| 模块 | 知识点 | 掌握程度 | 对应题库章节 |
|---|---|---|---|
| 输入 | Input Manager / Input System / 事件映射 | 会用 | 13.2 Unity |
| 状态机 | FSM、层次状态机、行为树直觉 | 能讲清原理 | 13.1 引擎通用基础 |
| 碰撞 | Collision / Trigger / Layer Matrix | 能讲清原理 | 13.1 引擎通用基础 |
| 对象池 | 池化、预热、回收、复用 | 能讲清原理 | 13.2 Unity |
| 射线 | Raycast、Layer Mask、命中信息 | 会用 | 13.8 实时渲染与图形学进阶 |
| 寻路 | NavMesh、Agent、OffMeshLink | 会用 | 13.1 引擎通用基础 |
| 配置 | ScriptableObject、JSON 配置 | 会用 | 13.2 Unity |
五、分模块精讲
5.1 输入系统
为什么需要它:硬编码 Input.GetKey(KeyCode.A) 在不同主机上完全不能用。新输入系统把「动作」与「按键」解耦,改键、手柄、触屏都能配。
核心机制:
- Unity 旧 Input:
Input.GetAxis("Horizontal")、Input.GetButtonDown("Jump"),在 Input Manager 配置。 - Unity 新 Input System:
InputAction Asset,按「动作」订阅,支持多设备。 - Godot:
Input Map里定义动作,Input.is_action_pressed("move_left")。 - 动作命名:
Move、Jump、Attack、Dodge,不要写KeyA。
最小可运行示例:
// Unity 旧输入:玩家水平移动
public class Player : MonoBehaviour
{
public float speed = 5f;
void Update()
{
float h = Input.GetAxis("Horizontal");
transform.Translate(h * speed * Time.deltaTime, 0, 0);
}
}
# Godot
extends CharacterBody3D
const SPEED := 5.0
func _physics_process(delta: float) -> void:
var dir := Input.get_axis("move_left", "move_right")
velocity.x = dir * SPEED
move_and_slide()
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 帧率高移动快 | 没用 Time.deltaTime |
乘 Time.deltaTime |
| 手柄没反应 | 旧 Input 默认不识别 | 用新 Input System 或配置 |
面试考法:问「为什么用 Time.deltaTime」。要答到「与帧率解耦,高屏与低屏手感一致」。
5.2 状态机
为什么需要它:玩家有 idle、run、jump、attack、roll 五种状态,状态之间有转移规则(攻击中不能翻滚、空中不能攻击)。用 if-else 写会变成 500 行的乱麻。
核心机制:
- 有限状态机 FSM:状态、转移条件、进入/退出动作。
- 每个状态一个类或一个 case,
Enter、Update、Exit三个钩子。 - 层次状态机 HFSM:父状态共享逻辑,子状态覆盖。
- 行为树 BT:更复杂的 AI(选择、序列、并行),本阶段先掌握 FSM。
最小可运行示例:
// Unity:极简 FSM
public enum PlayerState { Idle, Run, Jump, Attack }
public class PlayerFSM : MonoBehaviour
{
public PlayerState State { get; private set; }
public void ChangeState(PlayerState next)
{
State = next;
}
void Update()
{
switch (State)
{
case PlayerState.Idle: if (Mathf.Abs(Input.GetAxis("Horizontal")) > 0.1f) ChangeState(PlayerState.Run); break;
case PlayerState.Run: if (Input.GetButtonDown("Jump")) ChangeState(PlayerState.Jump); break;
case PlayerState.Jump: if (IsGrounded()) ChangeState(PlayerState.Idle); break;
case PlayerState.Attack: if (IsAttackDone()) ChangeState(PlayerState.Idle); break;
}
}
bool IsGrounded() => true;
bool IsAttackDone() => true;
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 状态穿越 | 没禁止非法转移 | 在 ChangeState 里加白名单 |
| 攻击中能移动 | 状态没屏蔽输入 | 在 Attack 状态里忽略移动输入 |
面试考法:问「状态机与行为树的区别」。要答到「FSM 简单、HFSM 层次、BT 适合复杂 AI 决策」。
5.3 碰撞与触发
为什么需要它:碰到敌人掉血、拾取金币、踩到按钮,这些都是碰撞。但地面碰撞要反弹、金币只触发不反弹,两种语义要分清。
核心机制:
- Collider:碰撞体,有 Is Trigger 勾选。
OnCollisionEnter:物理碰撞,有反弹,能拿到接触点与速度。OnTriggerEnter:触发,无反弹,只在两个物体都有 Collider 且至少一个有 Rigidbody 时触发。- Layer Matrix:Project Settings → Physics,配置哪两层碰撞、哪两层只触发。
- Godot:
Area3D做触发,CharacterBody3D做移动碰撞。
最小可运行示例:
// Unity:拾取金币
public class Coin : MonoBehaviour
{
void OnTriggerEnter(Collider other)
{
if (other.CompareTag("Player"))
{
GameScore.Add(1);
Destroy(gameObject);
}
}
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 触发不调用 | 双方都没 Rigidbody | 至少一方挂 Rigidbody 且 Is Kinematic 可勾 |
| 穿透地面 | 没有 Collider | 给地面加 BoxCollider |
| Layer Matrix 全勾 | 性能差且误触发 | 按需配置,UI 与世界层分开 |
面试考法:问「OnCollisionEnter 与 OnTriggerEnter 的区别」。要答到「前者有物理反弹,后者只是事件」。
5.4 对象池
为什么需要它:每发一颗子弹 Instantiate、销毁时 Destroy,手机上 GC 每 2 秒抖动一次,掉帧明显。对象池预分配对象,复用而非销毁。
核心机制:
- 池:一个
Queue<GameObject>,预热 N 个对象,全部 SetActive(false)。 - 取:从队列取一个,SetActive(true),重置状态。
- 还:SetActive(false),放回队列。
- 适用:子弹、敌人、特效、伤害飘字。
最小可运行示例:
// Unity:简单对象池
using System.Collections.Generic;
using UnityEngine;
public class BulletPool : MonoBehaviour
{
public static BulletPool Instance;
public GameObject bulletPrefab;
public int prewarm = 50;
private Queue<GameObject> pool = new();
void Awake()
{
Instance = this;
for (int i = 0; i < prewarm; i++)
{
var b = Instantiate(bulletPrefab);
b.SetActive(false);
pool.Enqueue(b);
}
}
public GameObject Get()
{
var b = pool.Count > 0 ? pool.Dequeue() : Instantiate(bulletPrefab);
b.SetActive(true);
return b;
}
public void Release(GameObject b)
{
b.SetActive(false);
pool.Enqueue(b);
}
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 池里对象状态残留 | 取用时没重置 | Get 时重置位置、速度、生命周期 |
| 池越来越大 | Release 没被调用 | 子弹到期时调 Release |
| 池太小不够用 | 预热不足 | 动态扩容,或提高 prewarm |
面试考法:问「为什么 Instantiate/Destroy 在手机上会掉帧」。要答到「触发 GC、分配内存、触发物理重算」。
5.5 射线检测与协程
为什么需要它:点击地面移动、瞄准敌人、UI 与世界物体区分,都需要射线。协程用来做「延迟 2 秒后爆炸」「1 秒内减速」这类时序逻辑,避免在 Update 里写一堆计时器。
核心机制:
- 射线:从相机发出,沿方向前进,命中第一个物体。
Physics.Raycast带 Layer Mask,只命中关心的层。- 协程:
StartCoroutine,yield return new WaitForSeconds(1),yield break停止。 - Godot:用
get_tree().create_timer(1).timeout信号,不写协程。
最小可运行示例:
// Unity:点击地面移动
public class ClickMove : MonoBehaviour
{
void Update()
{
if (Input.GetMouseButtonDown(0))
{
Ray ray = Camera.main.ScreenPointToRay(Input.mousePosition);
if (Physics.Raycast(ray, out RaycastHit hit, 100f, LayerMask.GetMask("Ground")))
{
transform.position = hit.point;
}
}
}
}
// 协程:延迟爆炸
IEnumerator ExplodeAfter(float delay)
{
yield return new WaitForSeconds(delay);
Destroy(gameObject);
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| UI 点击穿透到世界 | 射线没排除 UI 层 | Layer Mask 排除 UI 层 |
| 协程停不掉 | 没保存 Coroutine 引用 | StopCoroutine(handle) |
面试考法:问「协程是不是多线程」。要答到「不是,协程在主线程按帧调度,只是逻辑上分段执行」。
5.6 寻路与 ScriptableObject
为什么需要它:敌人追玩家不能穿墙、卡墙角。NavMesh 让引擎在场景里预计算可行走网格,Agent 沿网格走。ScriptableObject 把敌人配置(血量、速度、伤害)从代码里抽出来,改数值不重编译。
核心机制:
- NavMesh:场景静态烘焙,标记可行走区域。
- NavMeshAgent:挂在敌人上,
SetDestination(player.position)。 - OffMeshLink:跳跃点、台阶自动跨越。
- ScriptableObject:
CreateAssetMenu生成资产,在 Inspector 配置数值。
最小可运行示例:
// Unity:敌人追玩家
using UnityEngine;
using UnityEngine.AI;
public class EnemyChase : MonoBehaviour
{
public Transform target;
private NavMeshAgent agent;
void Start() => agent = GetComponent<NavMeshAgent>();
void Update()
{
if (target != null) agent.SetDestination(target.position);
}
}
// ScriptableObject 配置
using UnityEngine;
[CreateAssetMenu(menuName = "Game/Enemy Config")]
public class EnemyConfig : ScriptableObject
{
public float maxHp = 100;
public float speed = 3f;
public float damage = 10;
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 敌人卡在墙里 | NavMesh 未烘焙 | 重新 Bake,检查 obstacle 层 |
| 敌人走空气 | 地面没标 Navigation Static | 勾选 Static → Navigation |
面试考法:问「NavMesh 与 A* 的区别」。要答到「NavMesh 离线烘焙、A* 在线搜索、NavMesh 适合小场景、A* 适合动态网格」。
六、分层练习
6.1 复现型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 五状态玩家 | idle/run/jump/attack/roll | 状态切换无穿越 | 4 小时 |
| 对象池子弹 | 开枪 100 次无 GC 分配 | Profiler 看 GC 为 0 | 3 小时 |
| 拾取金币 | 走过金币加分销毁 | OnTriggerEnter 正常 | 1 小时 |
| 点击移动 | 鼠标点地面玩家走过去 | 射线命中地面层 | 2 小时 |
| NavMesh 追敌 | 敌人绕开障碍追玩家 | 不穿墙、不卡墙角 | 3 小时 |
6.2 改造型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 状态机加翻滚 | 空中不能翻滚、攻击中不能翻滚 | 转移条件白名单 | 2 小时 |
| 对象池扩容 | 预热 20 个,射击 50 次 | 动态扩容不报错 | 2 小时 |
| 配置外置 | 用 ScriptableObject 配 3 种敌人 | 改数值不重编译 | 2 小时 |
6.3 设计型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 设计玩家状态图 | 画出至少 6 个状态与转移 | 标注进入/退出条件 | 2 小时 |
| 设计对象池策略 | 列出哪些对象走池、预热多少 | 每个对象有依据 | 1 小时 |
| 设计敌人 AI | 巡逻 → 发现 → 追击 → 丢失 | 用 FSM 或行为树表达 | 3 小时 |
七、排障表
| 现象 | 可能原因 | 排查步骤 | 解决办法 |
|---|---|---|---|
| 帧率高移动快 | 没乘 Time.deltaTime | 看移动代码 | 乘 Time.deltaTime |
| 触发不调用 | 双方无 Rigidbody | 检查 Collider 与 Rigidbody | 至少一方挂 Rigidbody |
| 穿透地面 | 无 Collider | 检查地面组件 | 加 BoxCollider |
| 子弹多了掉帧 | 每次 Instantiate/Destroy | Profiler 看 GC | 改对象池 |
| UI 点击穿透世界 | 射线未排除 UI 层 | 看 Layer Mask | 加 LayerMask.GetMask 排除 |
| 敌人穿墙 | NavMesh 未烘焙 | 看 Navigation 窗口 | 重新 Bake |
| 状态穿越 | 转移无白名单 | 看 ChangeState | 加合法转移表 |
| 协程停不掉 | 未保存引用 | 看 StartCoroutine | 保存 Coroutine 句柄 |
八、出口条件
全部勾选后进入 阶段 3 图形渲染基础。
- [ ] 能用状态机实现五状态玩家,转移条件清晰
- [ ] 能用对象池管理子弹,开枪 100 次 GC 为 0
- [ ] 能区分 OnCollisionEnter 与 OnTriggerEnter 并正确使用
- [ ] 能用射线做点击移动或瞄准,UI 不穿透
- [ ] 能用 NavMesh 实现敌人绕障碍追击
- [ ] 能用 ScriptableObject 外置敌人配置
- [ ] 排障表里随机抽三个现象,能在 5 分钟内给出排查路径
自测题:
- 为什么用 Time.deltaTime?
- 要点:与帧率解耦,高屏与低屏手感一致。
- OnCollisionEnter 与 OnTriggerEnter 的区别?
- 要点:前者有物理反弹,后者只是事件,需要 Rigidbody 才触发。
- 对象池解决什么问题?
- 要点:避免频繁 Instantiate/Destroy 引发的 GC 抖动。
- 协程是不是多线程?
- 要点:不是,主线程按帧调度,逻辑分段执行。
- 状态机为什么不能用 if-else 堆?
- 要点:状态多了转移条件混乱,改一处动全身。
- NavMesh 的原理?
- 要点:离线烘焙可行走网格,Agent 沿网格走,不做实时 A*。