1. 前置安装

• Unity Netcode for GameObjects（版本：1.2.0）
在 Package Manager 中导入：
1. 打开 Window → Package Manager
2. 搜索并安装 “Netcode for GameObjects”（版本 ≥ 1.2.0）。

• Unity Transport
在 Netcode 安装完成后，同样在 Package Manager 中安装 “Unity Transport”（UTP）。

• 推荐工具
• Quantum Console：支持在打包后实时查看日志，方便调试。

2. 核心组件：NetworkManager

1. 在场景中新建空对象，添加 NetworkManager 组件。

2. Transport 选择为 Unity Transport。

3. 在 NetworkManager 下配置：
• Player Prefab：将玩家预制体拖入。

3. 玩家预制体配置

1. 在玩家预制体上添加 NetworkObject 组件。

2. 将所有需要网络同步的脚本从 MonoBehaviour 改为 NetworkBehaviour，以标记它们为网络脚本。

4. 变换（Transform）同步：NetworkTransform

• 默认行为：
• 服务器（Host/Server）权威，客户端只能被动接收同步数据。

4.1 客户端授权（Client Authority）

• 将原来的 NetworkTransform 替换为 ClientNetworkTransform。

• 在客户端中通过 ServerRpc 告知服务器移动请求。

5. RPC 与移动控制

• ServerRpc：客户端 → 服务器

• ClientRpc：服务器 → 客户端

注意：RequireOwnership = false 允许非拥有者（即客户端）调用。

6. 动画同步：NetworkAnimator

• 默认也是服务器权威。

• 同样可通过继承关闭服务器权威，实现客户端优先同步：

• 在角色预制体上替换为 OwnerNetworkAnimator，并将所有动画控制逻辑置于继承自 NetworkBehaviour 的脚本中。

7. NetworkBehaviour 生命周期

• 不建议在 Awake()/Start() 中做网络相关初始化。

• 推荐使用：

8. 单例（Singleton）注意

• 多人环境下，玩家对象并非一开始就实例化，避免在 Awake() 中将自身注册到全局单例。

• 如需单例管理，建议使用场景管理器（非玩家对象管理） 或者在 OnNetworkSpawn 中注册。

9. 生成与销毁网络对象

• 只可由服务端 调用 NetworkObject.Spawn() 或 Despawn()。

• 客户端通过 ServerRpc 请求，服务器收到后执行生成/销毁。

10. 传递复杂类型

• RPC 仅支持基础类型。

• 传递自定义对象时，可使用 NetworkObjectReference：

注意：网络对象 不能 作为非网络对象的子物体。

11. 网络变量（NetworkVariable）

• 写权限：仅服务器

• 读权限：客户端（只读）

• 客户端不能直接访问底层字段，需通过 API 读取 NetworkVariable<T>.Value。

12. 常用属性对照

快速记忆

• IsClient：“我是不是客户端？” （能看见画面）

• IsServer：“我是不是服务器？” （掌控世界状态）

• IsOwner：“这是我控制的对象吗？” （我可以操作）

1. 大厅功能API