Unity Netcode for GameObjects 多人联机开发基础

空间对齐#

为什么需要对齐？

假设同一个现实空间有两个玩家，玩家在 Unity 中的初始坐标都是 (0, 0, 0)。但玩家戴上头显时，头显在现实中的初始位置和朝向决定了玩家的 Unity 原点位置和朝向。

权威（Authority）#

Client、Server、Host 区别#

Host 写逻辑需要区分 Server/Client

权威规则示例#

错误做法：

• Client 自己改血量、位置、状态 ✗
• Client 自己判定命中 ✗

正确流程：

1
Client（玩家）发射子弹
2
↓
3
Server 判断子弹有没有命中
4
↓
5
得出结果：命中/未命中
6
↓
7
把结果同步给所有人

子弹生成流程：

1
Client 扣下扳机
2
↓
3
Client 向 Server 申请开枪
4
↓
5
Server 验证：冷却时间？弹药？状态？
6
↓
7
Server 实例化子弹物体
8
↓
9
Server 把子弹同步给 Client

核心原则：写代码前想好这段代码是在当玩家，还是当裁判。凡是能够影响别人结果的，都是由 Server 进行生成和判定。

安装#

在 Unity Package Manager 的 Unity Registry 搜索 Netcode for Gameobjects，进行安装。

基础配置#

1. 在场景中新增一个空物体（如 Network Manager）
2. 在物体上添加 NetworkManager 脚本
3. 一个场景只能有一个 NetworkManager 脚本
4. 在 NetworkManager 的 Network Transport 处选择 Unity Transport 作为网络传输层

多实例调试工具 ParrelSync#

下载：https://github.com/VeriorPies/ParrelSync

1. 下载 unitypackage 并导入 Unity
2. 点击菜单栏 ParrelSync > Clone Manager 克隆 Unity 工程
3. Open In New Editor 打开
4. 可在多个相同工程里模拟不同客户端/服务端
5. 主工程修改后克隆的工程会同步修改

NetworkManager#

整个联机世界的开关，负责：

• 启动 Server / Client / Host
• 管理玩家连接
• 管理 Player Prefab
• 管理网络生命周期

Player Prefab#

每个客户端玩家在联机世界中代表自己的游戏对象，相当于自己在联机世界的化身。

在 NetworkManager 组件的 Player Prefab 字段中进行指定。

NetworkObject#

联机世界的身份证，允许物体进入联机世界。

NetworkBehaviour#

继承自 NetworkBehaviour 的脚本能够处理联机逻辑。

特点#

工作机制#

• 自动同步：值改变后，NGO 自动处理网络通信（只有值变化后才同步，不是每帧同步）
• 状态同步：中途加入的客户端会自动同步服务器的当前状态
• 变更回调：提供 OnValueChanged 事件，可在值改变时执行自定义逻辑

代码写法#

1
// 权威规则
2
// Server 写（只能服务端修改数值，修改后所有客户端会自动同步）
3
// Client 读
4

5
public class HealthSystem : NetworkBehaviour
6
{
7
    public NetworkVariable<int> health = new NetworkVariable<int>(100);
8

9
    // Server 端修改
10
    public void TakeDamage(int damage)
11
    {
12
        health.Value -= damage; // 只有 Server 有权限
13
    }
14
}

常见错误#

错误一：Client 直接改 NetworkVariable

1
// ❌ 错误：客户端自己执行
2
health.Value -= 100;
3

4
// 后果：客户端没有权利判定结果

错误二：用 NetworkVariable 同步瞬时事件

1
// ❌ 错误：开枪是瞬时事件，不是长期状态
2
isShooting.Value = true;
3

4
// 后果：玩家一直维持开枪状态

错误三：每帧修改 NetworkVariable

1
// ❌ 错误：Update 里不断改血量
2
void Update()
3
{
4
    health.Value = currentHealth;
5
}
6

7
// 后果：性能消耗大

XR 输入同步例外：XR 中需要实时同步头显、手柄输入到远端 Player，这是输入流需要持续更新。

IsOwner 含义#

我有没有资格发请求。当前生成的 Player 是不是由我这个客户端控制的。

例如：客户端 A 先加入，然后客户端 B 加入。A 的世界里生成了代表 B 的 Player，但 A 客户端的这个 B 不归 A 管，所以不会触发 Move。而 B 世界里生成的 B 归自己管，所以一生成就调用 Move。

IsOwner 和 IsLocalPlayer 区别#

ServerRPC（Client → Server）#

客户端向服务端发起请求，执行的代码在服务端执行。

1
[ServerRpc]
2
void ShootServerRpc()
3
{
4
    // 执行在服务端
5
    Debug.Log("Server 处理开枪逻辑");
6
}

ClientRPC（Server → Client）#

服务端向客户端发起通知。

1
[ClientRpc]
2
void ExplodeClientRpc()
3
{
4
    // 执行在所有客户端
5
    PlayExplosionEffect();
6
}

HelloWorldPlayer 与 HelloWorldManager#

执行流程：

1
Client 按按钮
2
↓
3
ServerRpc
4
↓
5
Server 决定位置
6
↓
7
NetworkVariable 同步结果
8
↓
9
所有 Client 更新显示