Unity NetworkManager 组件解析

禾光
0 阅读6分钟

多人联机开发中，NetworkManager 就是整个 Netcode 框架的「大脑」与「心脏」。它管着连接、生成、同步、场景、性能……几乎所有网络相关的核心逻辑。

一、引言

在 Unity 官方主推的 Netcode for GameObjects（简称 NGO） 框架中，NetworkManager 组件是当之无愧的 全局控制中心。它不只是一个简单的管理器，而是整个联机架构的「总指挥」：

  • 管理服务器/客户端的启动、连接、断连状态
  • 统一注册网络预制体，实现跨端动态生成
  • 控制网络帧速率、带宽、插值等性能参数
  • 处理场景同步、连接审批、ID 回收等高级逻辑
  • 提供编辑器快速启动连接的调试入口

二、面板总览

image.png

NetworkManager 是 NGO 框架的单例组件，场景中只能存在一个激活实例（多实例会报错）。它的 Inspector 面板大致分为以下几个模块：

模块核心作用
顶部提示栏引导安装 Multiplayer Tools 工具包
基础运行配置后台运行、日志级别、玩家预制体
网络预制体列表注册所有需要动态生成的网络物体
通用网络核心协议版本、传输层、网络帧速率
性能优化网络变量插值
连接安全与超时连接审批、超时时间
生成与 ID 管理预制体强制一致、ID 回收机制
带宽优化RPC 哈希编码格式
场景同步内置场景管理系统
连接启动入口Editor 快速启动按钮

三、逐模块

1. 顶部提示栏：Multiplayer Tools 工具包

面板最顶部有一个提示条，引导你安装 Multiplayer Tools。

  • 作用：该工具包提供了网络分析器、性能监控、网络调试、流量统计等一系列联机开发必备工具。
  • 开发建议：开发阶段必须安装。通过 Package Manager → 搜索 Multiplayer Tools 即可一键安装。发布项目时可以保留，用于线上问题排查。

2. 基础运行配置：联机游戏的必设基础项

配置项功能说明开发建议
Run In Background勾选后，游戏在后台运行时仍保持网络连接联机游戏强制勾选。否则玩家切到后台就直接断连，体验血崩。纯单机可忽略。
Log Level控制网络日志输出级别：Error / Normal / Debug开发期用 Debug，方便排查连接、同步问题；发布期用 Error，减少日志开销。
Player Prefab玩家预制体，客户端连接时服务器自动生成预制体必须挂载 NetworkObject 组件，否则无法生成。建议同时挂载 NetworkTransform（位置同步）和 NetworkAnimator（动画同步）。

3. Network Prefabs Lists：网络预制体统一管理

这个列表用于注册所有需要在网络中动态生成的预制体（怪物、道具、特效、子弹等）。

  • 核心作用：调用 Spawn() 方法前，预制体必须在此注册，否则服务器无法将其同步到客户端。
  • 配置方式：可以直接在面板中添加单个预制体，也可以使用 NetworkPrefabsList 资产统一管理（推荐大型项目）。
  • 常见坑：新手最常犯的错误就是忘记注册预制体，然后调用 Spawn() 时直接报错。务必养成注册习惯。

4. General：通用网络核心配置

配置项功能说明开发建议
Protocol Version网络协议版本号，用于客户端-服务器版本校验只有版本号完全一致的客户端才能连接。大版本更新时必须修改此值，避免旧客户端连入导致同步异常。
Network Transport网络传输层，NGO 默认使用 Unity Transport（基于 UDP 的轻量传输）满足绝大多数场景，无需修改。如需 P2P 跨网联机，可集成 Unity Relay 服务。
Tick Rate网络帧速率（次/秒），服务器/客户端每秒处理网络消息的次数30 是平衡性能与同步的黄金值。动作/竞技类游戏可提升至 45–60，提升流畅度；休闲/回合制可降至 20–30，节省带宽。

⚠️ 注意：Tick Rate 不是帧率，而是网络消息的处理频率。调高会增强同步精度，但也会增加带宽和 CPU 开销。

5. Performance：网络性能优化

配置项功能说明开发建议
Ensure Network Variable Lerp控制 NetworkVariable 是否启用插值平滑勾选后网络变量会做插值运算，大幅减少抖动带来的卡顿和瞬移。联机游戏建议必勾。仅在同步精度要求极高的场景可关闭。

6. Connection：连接安全与超时控制

配置项功能说明开发建议
Connection Approval启用连接审批，支持自定义玩家连接校验逻辑正式项目必须启用。可以通过代码实现黑名单、Token 校验、房间人数限制等自定义逻辑，防止非法连接。
Client Connection Buffer Timeout客户端连接缓冲超时时间（秒）客户端发起连接后，若在指定时间内未完成则自动断开。默认 10 秒，弱网环境可适当延长至 15–20 秒。

7. Spawning：网络对象生成与 ID 管理

这个模块是长时间运行服务器的关键配置。

配置项功能说明开发建议
Force Same Prefabs强制客户端与服务器的网络预制体完全一致避免预制体版本不一致导致的生成异常，正式项目必勾。
Recycle Network Ids启用 NetworkObjectId 回收机制销毁网络对象后回收其 ID 复用，避免长时间运行的服务器 ID 耗尽。长线项目必勾。
Network Id Recycle DelayID 回收延迟时间（秒）销毁对象后等待指定时间再回收 ID，避免客户端延迟导致的 ID 冲突。默认 120 秒，一般 60–120 秒足够。

🧠 原理：每个网络对象都有唯一的 NetworkObjectId。如果不回收，服务器运行几天后可能 ID 耗尽，无法生成新对象。回收机制通过延迟复用避免冲突。

8. Bandwidth：带宽优化配置

配置项功能说明开发建议
Rpc Hash SizeRPC（远程过程调用）哈希值的编码格式，可选 Two Bytes / Four Bytes / Var Int Four Bytes默认 Var Int Four Bytes，支持大项目的海量 RPC 数量。小项目可选择 Two Bytes 节省带宽。

9. Scene Management：场景同步管理

配置项功能说明开发建议
Enable Scene Management启用 NGO 内置场景管理系统勾选后由服务器主导场景加载，客户端自动同步场景状态，避免手动同步的复杂逻辑。绝大多数项目建议启用。
Load Scene Time Out场景加载超时时间（秒）服务器加载场景后，客户端在指定时间内未完成加载则断开。默认 120 秒，大型场景可适当延长。

10. Start Connection：连接启动入口

面板底部的三个按钮，仅在 Editor 运行时可用：

  • Start Host：启动主机（同时作为服务器+客户端），适合开房间、本地联机、单人开服。
  • Start Server：仅启动服务器，不启动本地客户端，适合专用服务器部署。
  • Start Client：仅启动客户端，连接到指定服务器。

📦 打包后需通过代码调用 NetworkManager.StartHost() / StartServer() / StartClient() 启动连接，面板按钮无效。

🔗 进阶学习资源

avatar
文章
阅读
粉丝