1. 项目概述为什么选择Mirror来构建你的第一个多人游戏如果你正在Unity里捣鼓一个游戏原型突然灵光一闪“要是能和朋友一起玩就好了”那你大概率会一头扎进Unity网络同步的深坑里。Unity自带的UNETUnity Networking早已被官方弃用留下一个巨大的空白。这时Mirror横空出世它本质上是一个社区维护的、对UNET高层APIHLAPI的重新实现和增强。这意味着如果你曾经看过一些老旧的UNET教程Mirror的代码看起来会非常眼熟学习曲线相对平缓。它抽象掉了底层复杂的网络传输细节让你能更专注于游戏逻辑的同步。Mirror的核心优势在于它的“状态同步”机制。简单来说它帮你把游戏世界里每个对象比如玩家角色、一个宝箱、一颗子弹的“状态”位置、旋转、血量、是否开门从服务器Host自动同步到所有客户端。你不需要手动发送“玩家A移动到了10 5 0”这样的消息只需要在代码里修改这个玩家的位置Mirror的底层框架会帮你检测变化并同步。这对于回合制游戏、RPG、MOBA甚至一些对实时性要求不是极端苛刻的FPS原型来说是最高效的开发方式。那么谁适合这个教程我假设你已经有基础的Unity和C#知识知道如何创建GameObject、挂载脚本、使用Update函数。你可能是独立开发者、学生或者是一个想为单机游戏添加多人模式的小团队成员。这个教程的目标不是让你立刻做出一个商业级的《英雄联盟》而是带你扎实地走通从零搭建一个可运行的多人游戏demo的全过程理解每一个环节“为什么”要这么做避开我当年踩过的那些坑。2. 环境准备与项目初始化搭建稳固的地基在开始写任何一行网络代码之前一个干净、正确的项目环境至关重要。很多稀奇古怪的错误都源于第一步没走对。2.1 创建项目与导入Mirror首先打开Unity Hub创建一个全新的3D核心模板项目。项目名称随意比如“MirrorBasics”。创建完成后不要急着做别的我们先导入Mirror。最推荐的方式是通过Unity的Package Manager从Git URL添加。点击菜单栏Window Package Manager在窗口左上角点击“”号选择“Add package from git URL...”。在弹出的输入框中粘贴Mirror在GitHub上的最新稳定版URL。你可以去Mirror的GitHub仓库通常搜索“Mirror Networking”就能找到查看最新的发布版本使用类似https://github.com/vis2k/Mirror.git?path/Assets这样的地址。这种方式能确保你获取到的是未经修改的官方源码便于后续排查问题和更新。注意不建议从Asset Store或其他第三方渠道下载打包好的Mirror版本可能滞后且可能包含未知的修改。直接从Git仓库导入是最纯净的方式。导入过程可能会花费一两分钟成功后你会在Project窗口的Assets文件夹里看到一个名为“Mirror”的文件夹。同时菜单栏会多出一个“Mirror”选项。这时你可以检查一下Package ManagerMirror应该已经出现在“My Registries”或“In Project”列表里了。2.2 关键组件初识Network Manager与场景设置导入Mirror后第一个要认识的核心组件是Network Manager。它是整个Mirror多人游戏的“大脑”和“调度中心”。我们不需要自己从头写一个Mirror提供了现成的预制件。在Project窗口中找到Assets/Mirror/Examples/文件夹里面有很多官方示例。我们先找一个最简单的比如“Basic”或“Tanks”将其中的场景打开看看。不过对于我们的基础教程我建议你亲手创建一个。回到你自己的空场景SampleScene。在Hierarchy中右键选择Create Empty将这个空物体命名为“NetworkManager”。然后选中它在Inspector面板点击“Add Component”搜索并添加Network Manager组件。你还会需要另一个组件KCP Transport或Telepathy Transport。Transport是传输层负责处理底层的网络数据包。KCP是一个快速可靠的协议适合大多数情况Telepathy更简单轻量。我们选择KCP Transport同样通过Add Component添加。现在你的NetworkManager物体上应该有两个组件Network Manager和KCP Transport。我们需要对Network Manager进行一些基本配置。在它的Inspector面板中你会看到很多字段Offline Scene / Online Scene: 分别填写你的离线如主菜单和在线游戏主场景场景的名字。我们先都填当前场景的名字如“SampleScene”。Player Prefab: 这是最重要的设置之一。它定义了当玩家加入游戏时会在场景中生成什么样的预制件作为他的角色。我们先留空后面会创建。Spawn Info: 这里可以预置一些游戏开始后需要由服务器统一生成的对象列表比如地图上的物品、NPC。完成这些后将这个配置好的NetworkManager物体拖到Project窗口的Assets文件夹里保存为一个Prefab预制件。这样以后在任何场景中你都可以直接拖入这个预制件来获得一个配置好的网络管理器保证了配置的一致性。3. 核心概念与脚本编写理解权威与同步多人游戏编程和单机游戏一个最根本的思维转变在于你需要时刻思考“这个操作由谁执行这个数据谁说了算”3.1 NetworkIdentity与NetworkBehaviour对象的“身份证”和“能力”在Mirror中任何一个需要在网络上存在的GameObject都必须挂载NetworkIdentity组件。你可以把它理解为这个物体在网络世界里的“身份证”。有了它Mirror才能唯一地识别和管理这个对象。而NetworkBehaviour是一个基类你需要让你自己编写的、包含网络逻辑的脚本继承自它而不是默认的MonoBehaviour。继承自NetworkBehaviour的脚本会自动获得一系列强大的网络相关属性和方法。让我们创建一个最简单的玩家角色。首先在场景中创建一个Cube或一个胶囊体Capsule命名为“Player”。然后为它添加NetworkIdentity组件。接着我们创建一个C#脚本命名为PlayerController。打开脚本将基类从MonoBehaviour改为NetworkBehaviour。using Mirror; using UnityEngine; public class PlayerController : NetworkBehaviour { public float moveSpeed 5f; void Update() { // 关键只有本地玩家才能控制这个角色 if (!isLocalPlayer) return; float h Input.GetAxis(Horizontal); float v Input.GetAxis(Vertical); Vector3 movement new Vector3(h, 0, v) * moveSpeed * Time.deltaTime; transform.Translate(movement); } }注意if (!isLocalPlayer) return;这行代码。这是多人游戏脚本的“黄金法则”。isLocalPlayer是NetworkBehaviour提供的一个属性只有当这个脚本实例运行在“属于当前客户端”的那个玩家对象上时它才为true。这行代码确保了每个客户端只处理自己角色的输入而不会错误地去移动其他玩家的角色。其他玩家的移动将由Mirror通过状态同步自动更新到你的机器上。将这个PlayerController脚本挂载到刚才的Player物体上。现在这个Player物体带有NetworkIdentity和你的脚本就是一个“网络预制件”的雏形。把它从Hierarchy拖到Project的Assets中保存为一个Prefab命名为“PlayerPrefab”。然后回到之前创建的NetworkManager预制件在Inspector中找到Player Prefab字段将这个PlayerPrefab拖拽赋值进去。3.2 [Command] 与 [ClientRpc]跨越客户端的指令isLocalPlayer解决了本地控制的问题但很多游戏行为需要从客户端发起最终由服务器来裁决和执行再广播给所有客户端。比如玩家开枪、使用技能、拾取物品。这就需要用到[Command]和[ClientRpc]。[Command]: 这是一个“由客户端调用在服务器上执行”的方法。想象一下你客户端向服务器发送了一个“请求开枪”的指令。只有标记了[Command]的方法才能被客户端调用通常以Cmd为前缀命名并且它会在拥有此对象的服务器实例上运行。[ClientRpc]: 这是一个“由服务器调用在所有客户端上执行”的方法。当服务器处理完一个Command比如确认子弹命中它需要告诉所有客户端“更新画面显示命中效果”。标记了[ClientRpc]的方法通常以Rpc为前缀命名就会被服务器调用并在所有连接的客户端上触发。让我们为玩家添加一个简单的“跳跃”功能这个功能需要服务器验证。public class PlayerController : NetworkBehaviour { // ... 之前的移动代码 ... void Update() { if (!isLocalPlayer) return; // 移动逻辑... float h Input.GetAxis(Horizontal); float v Input.GetAxis(Vertical); Vector3 movement new Vector3(h, 0, v) * moveSpeed * Time.deltaTime; transform.Translate(movement); // 检测跳跃输入 if (Input.GetButtonDown(Jump)) { CmdRequestJump(); // 客户端调用Command } } [Command] // 这个函数在客户端调用在服务器上运行 void CmdRequestJump() { // 服务器可以在这里进行验证比如检查玩家是否在地面上 // 这里我们简单处理直接执行跳跃逻辑 RpcPerformJump(); // 服务器调用Rpc通知所有客户端 } [ClientRpc] // 这个函数在服务器调用在所有客户端运行 void RpcPerformJump() { // 实际的跳跃视觉效果如播放动画、施加力在这里执行 // 因为它在所有客户端运行所以大家都能看到这个玩家跳起来了 GetComponentRigidbody().AddForce(Vector3.up * 5f, ForceMode.Impulse); Debug.Log(gameObject.name jumped!); } }这个流程是本地玩家按下空格 - 调用CmdRequestJump- 该命令在服务器上执行 - 服务器调用RpcPerformJump- 所有客户端包括操作者自己的该玩家物体都执行跳跃动作。实操心得在设计Command时一定要有“服务器是权威”的意识。客户端发送的Command只是一个“请求”所有重要的逻辑判断是否命中、伤害计算、物品所有权都必须在Command方法内即服务器端完成。客户端只负责发送意图和表现效果。这是防止外挂作弊的第一道防线。3.3 [SyncVar]自动同步的变量对于一些需要频繁同步的简单状态比如玩家的血量、分数、队伍颜色使用Command/Rpc来回通信有点大材小用。这时[SyncVar]属性就派上用场了。将一个公共变量标记为[SyncVar]当它在服务器上改变时Mirror会自动将新值同步给所有客户端。public class PlayerController : NetworkBehaviour { [SyncVar] public int playerHealth 100; [SyncVar(hook nameof(OnPlayerNameChanged))] public string playerName Player; void OnPlayerNameChanged(string oldName, string newName) { Debug.Log($Player name changed from {oldName} to {newName}); // 这里可以更新UI上的名字显示 } [Command] void CmdTakeDamage(int damage) { // 服务器权威地计算伤害 playerHealth - damage; if (playerHealth 0) { RpcRespawn(); } } }[SyncVar]非常高效但要注意只有服务器端修改[SyncVar]变量才会触发同步。客户端修改是无效的不会报错但不会同步给别人。可以使用hook参数指定一个回调函数。当变量同步到客户端时这个函数会被调用非常适合用来更新UI或触发视觉效果。如上面例子中的OnPlayerNameChanged。[SyncVar]同步的时机是在下一个同步帧不是立即的所以对实时性要求极高的状态如每帧变化的位置还是要用后面提到的NetworkTransform。4. 网络物体的生成与同步让世界动起来玩家角色只是网络物体的一种。游戏中的子弹、怪物、可拾取物品等都需要被网络管理起来。4.1 生成非玩家物体服务器需要负责生成所有客户端都能看到的物体。我们创建一个“子弹”预制件。创建一个Sphere命名为“Bullet”。添加NetworkIdentity组件。创建一个脚本Bullet.cs继承自NetworkBehaviour。添加简单的移动和碰撞销毁逻辑。将脚本挂到Bullet上做成预制件“BulletPrefab”。现在如何在玩家开枪时生成这颗子弹我们需要在PlayerController的Command中让服务器来生成。public class PlayerController : NetworkBehaviour { public GameObject bulletPrefab; // 在Inspector中拖入BulletPrefab public Transform firePoint; // 子弹生成点 void Update() { if (!isLocalPlayer) return; if (Input.GetMouseButtonDown(0)) { CmdFire(); } } [Command] void CmdFire() { // 服务器端生成子弹 GameObject bullet Instantiate(bulletPrefab, firePoint.position, firePoint.rotation); // 关键生成后必须调用NetworkServer.Spawn将物体纳入网络管理 NetworkServer.Spawn(bullet, connectionToClient); // 可选的为子弹添加一个力或速度这个逻辑应该在Bullet脚本的Start或OnStartServer中处理 } }NetworkServer.Spawn(object)是告诉Mirror“这个物体现在是一个网络物体了请把它同步给所有客户端。” 参数connectionToClient是可选的用于指定这个物体的“拥有者”。这里传入后这颗子弹就归属于发射它的玩家在一些权限判断时有用。4.2 使用NetworkTransform同步位置你可能会发现上面生成的子弹虽然在每个客户端都出现了但它的位置不会自动同步。为了让物体的Transform位置、旋转、缩放自动同步我们需要NetworkTransform组件。给“BulletPrefab”添加NetworkTransform组件。这个组件会定期可配置将物体的Transform信息从服务器同步到所有客户端。对于子弹这种高速移动的物体你可能需要调整NetworkTransform上的syncInterval同步间隔来获得更平滑的效果但要注意网络带宽消耗。对于玩家角色我们之前用transform.Translate移动这只是在本地修改。为了让其他客户端看到你移动你有两个选择继续使用NetworkTransform组件最简单。给PlayerPrefab也加上NetworkTransform这样你本地移动后NetworkTransform会自动将新位置同步出去。使用更权威的服务器移动。在Command中发送移动输入由服务器计算新位置再通过[SyncVar]或Rpc同步回来。这更安全但更复杂延迟也更明显。对于基础教程第一种方式更合适。注意事项NetworkTransform是“状态同步”它同步的是结果。对于高速移动的物体客户端会看到物体“瞬移”到新的同步位置。为了平滑NetworkTransform内置了插值Interpolation功能它会根据过去的位置数据在客户端上平滑地移动到最新位置。通常保持默认开启即可。如果你的游戏需要极致的操作手感如竞技FPS可能需要自己实现基于输入的预测和调和这属于高级话题。5. 游戏流程与房间管理从连接到开始游戏一个完整的多人游戏demo需要处理连接、断开、玩家准备、游戏开始等流程。5.1 启动主机与连接NetworkManager已经为我们封装了最基础的网络操作。在场景中放入NetworkManager预制件后我们可以创建简单的UI按钮来调用它。创建两个UI Button一个文本“Host (Server Client)”一个文本“Client”。为它们添加点击事件Host按钮调用NetworkManager.singleton.StartHost()。这个方法会同时启动一个服务器Server和一个本地客户端Local Client。Client按钮调用NetworkManager.singleton.StartClient()。这个方法会启动一个客户端并尝试连接到NetworkManager中设置的网络地址默认是localhost。你可以在NetworkManager组件的Inspector里设置服务器地址Network Address和端口Port。对于本地测试用localhost或127.0.0.1即可。5.2 简单的玩家准备与游戏开始逻辑通常我们需要一个“准备大厅”等所有玩家都准备就绪后再由主机服务器开始游戏。这需要一些自定义的网络逻辑。我们可以创建一个新的GameObject挂载一个继承自NetworkBehaviour的脚本比如GameLobbyManager。这个脚本只存在于服务器和每个客户端一份通过Network Identity。我们用它来管理游戏状态。using Mirror; using UnityEngine; using UnityEngine.UI; public class GameLobbyManager : NetworkBehaviour { // 用一个SyncVar来同步所有玩家是否准备就绪 [SyncVar(hook nameof(OnAllPlayersReadyChanged))] private bool allPlayersReady false; // 服务器上记录每个连接的准备状态 private System.Collections.Generic.DictionaryNetworkConnection, bool playerReadyStates new System.Collections.Generic.DictionaryNetworkConnection, bool(); // 当玩家加入时服务器端会调用这个函数需要在别处注册回调如NetworkManager的OnServerAddPlayer事件 public void OnServerAddPlayer(NetworkConnectionToClient conn) { playerReadyStates[conn] false; UpdateAllPlayersReadyState(); } // 玩家点击准备按钮客户端调用 [Command(requiresAuthority false)] // 允许无Authority的客户端调用 public void CmdPlayerReady(NetworkConnectionToClient sender null) { if (sender ! null playerReadyStates.ContainsKey(sender)) { playerReadyStates[sender] true; Debug.Log($Player {sender.connectionId} is ready.); UpdateAllPlayersReadyState(); } } // 更新并检查是否所有人都准备好了 void UpdateAllPlayersReadyState() { bool allReady true; foreach (var state in playerReadyStates.Values) { if (!state) { allReady false; break; } } allPlayersReady allReady; } // 当allPlayersReady变化时在所有客户端触发 void OnAllPlayersReadyChanged(bool oldValue, bool newValue) { if (newValue) { Debug.Log(All players are ready! Can start game.); // 这里可以显示一个“开始游戏”的按钮仅对主机可见 // 或者直接倒计时后自动开始 } } // 主机服务器调用开始游戏逻辑如切换场景 [Command(requiresAuthority false)] public void CmdStartGame() { if (allPlayersReady) { // 通知所有客户端游戏开始切换场景等 RpcLoadGameScene(); } } [ClientRpc] void RpcLoadGameScene() { // 使用NetworkManager加载在线场景确保网络状态正确迁移 NetworkManager.singleton.ServerChangeScene(GameplayScene); } }这个例子展示了如何结合[SyncVar]、[Command]和[ClientRpc]来构建一个简单的游戏流程管理器。你需要将这个脚本挂载的物体做成网络预制件并在游戏初始场景中通过NetworkServer.Spawn生成它或者将其注册到NetworkManager的“Registered Spawnable Prefabs”列表中并在场景中提前放置需有NetworkIdentity。6. 常见问题与调试技巧实录在实际开发中你会遇到各种各样的问题。这里记录几个最常见的问题和我的排查思路。6.1 连接失败与超时症状客户端无法连接到主机一直卡在连接中或直接失败。排查检查地址和端口确认客户端连接的IP地址和端口号与服务器监听的完全一致。局域网内使用本地IP如192.168.x.x本地测试用localhost。确保防火墙没有阻止Unity或对应端口。检查Transport组件确保服务器和客户端的GameObject上都有相同类型的Transport组件如都是KCP Transport且配置如端口匹配。查看控制台日志Mirror和Transport组件如KCP会输出详细的日志。在Unity Editor中注意Console窗口的日志级别选择“Verbose”或“Info”能看到更多连接握手信息。主机模式测试先尝试用StartHost()在单台机器上运行。如果主机模式正常但分离的客户端连接失败问题很可能在网络配置或防火墙。6.2 Command或Rpc不执行症状客户端点击按钮Command似乎没被调用服务器调用了Rpc客户端没反应。排查命名与调用方式Command方法必须以Cmd开头Rpc以Rpc开头。这是Mirror的硬性约定。调用Command时确保是从一个本地玩家对象isLocalPlayer为true或有Authority的对象上调用。参数序列化Command和Rpc方法的参数必须是Mirror支持的可序列化类型基本类型、Unity内置类型如Vector3、自定义结构体或类若标记了[System.Serializable]。传递一个复杂的MonoBehaviour引用会导致失败。权限检查检查Command上的requiresAuthority属性。如果你的Command允许无Authority的客户端调用比如大厅中的准备按钮需要显式设置为[Command(requiresAuthority false)]并且通常需要将NetworkConnectionToClient作为参数传入以识别调用者。网络状态确保调用Command时客户端已经成功连接到服务器并完成了玩家生成。在Start()或Awake()中调用Command通常会失败因为网络身份可能还未就绪。推荐在OnStartLocalPlayer()生命周期方法之后进行网络调用。6.3 物体不同步或位置抖动症状其他玩家看到的物体位置不对或者移动时一顿一顿的。排查NetworkIdentity和NetworkTransform确认所有需要同步的物体都有NetworkIdentity组件。对于需要同步位置/旋转的物体添加NetworkTransform组件。插值与同步速率NetworkTransform的syncInterval默认是0.1秒10次/秒。对于快速移动的物体如子弹、赛车可以尝试减小这个值如0.05秒但会增加带宽。同时确保Interpolation插值是开启的这会让移动更平滑。在服务器端移动如果物体是由服务器权威移动的比如NPC确保移动逻辑写在NetworkBehaviour的Update或FixedUpdate中并且没有被isLocalPlayer条件包裹。服务器端的物体isLocalPlayer永远是false。网络延迟这是固有的。Mirror的NetworkTransform使用快照插值来对抗延迟。如果抖动严重可以检查网络延迟Ping。在NetworkTransform组件上可以适当增加interpolationBackTime插值回溯时间给客户端更多的时间来缓冲和插值但这会增加显示延迟。6.4 错误“Spawn object not found”症状服务器尝试生成一个物体时客户端报错找不到预制件。排查注册预制件任何需要通过NetworkServer.Spawn动态生成的预制件都必须提前注册到NetworkManager中。在NetworkManager组件的Inspector面板找到 “Spawn Info” 折叠栏将你的预制件如BulletPrefab, EnemyPrefab拖入 “Registered Spawnable Prefabs” 列表。预制件一致性确保服务器和客户端工程中的预制件具有相同的名称和GUID通常意味着是同一个预制件文件。如果客户端没有这个预制件就无法实例化。生成时机确保在调用NetworkServer.Spawn之前物体已经被Instantiate了。调试网络游戏一个非常有效的方法是使用Unity Editor的“ParrelSync”工具可在GitHub找到。它允许你同时打开多个独立的Unity Editor实例模拟多个客户端并且项目资产是同步的极大方便了本地测试和调试。另一个笨办法但有效的方法是“Build and Run”一个客户端然后用Editor作为服务器或另一个客户端进行连接测试这样能发现一些只在独立运行时才出现的问题。最后保持耐心。多人游戏开发就是与状态同步、延迟和不确定性作斗争的过程。从这个小demo开始理解每一个基础概念然后逐步增加复杂度你会发现Mirror这个工具能帮你屏蔽很多底层烦恼让你更专注于游戏玩法本身的实现。当你第一次看到两个方块在同一个场景里由不同电脑控制着移动时那种成就感绝对是单机开发无法比拟的。
1. 项目概述为什么选择Mirror来构建你的第一个多人游戏如果你正在Unity里捣鼓一个游戏原型突然灵光一闪“要是能和朋友一起玩就好了”那你大概率会一头扎进Unity网络同步的深坑里。Unity自带的UNETUnity Networking早已被官方弃用留下一个巨大的空白。这时Mirror横空出世它本质上是一个社区维护的、对UNET高层APIHLAPI的重新实现和增强。这意味着如果你曾经看过一些老旧的UNET教程Mirror的代码看起来会非常眼熟学习曲线相对平缓。它抽象掉了底层复杂的网络传输细节让你能更专注于游戏逻辑的同步。Mirror的核心优势在于它的“状态同步”机制。简单来说它帮你把游戏世界里每个对象比如玩家角色、一个宝箱、一颗子弹的“状态”位置、旋转、血量、是否开门从服务器Host自动同步到所有客户端。你不需要手动发送“玩家A移动到了10 5 0”这样的消息只需要在代码里修改这个玩家的位置Mirror的底层框架会帮你检测变化并同步。这对于回合制游戏、RPG、MOBA甚至一些对实时性要求不是极端苛刻的FPS原型来说是最高效的开发方式。那么谁适合这个教程我假设你已经有基础的Unity和C#知识知道如何创建GameObject、挂载脚本、使用Update函数。你可能是独立开发者、学生或者是一个想为单机游戏添加多人模式的小团队成员。这个教程的目标不是让你立刻做出一个商业级的《英雄联盟》而是带你扎实地走通从零搭建一个可运行的多人游戏demo的全过程理解每一个环节“为什么”要这么做避开我当年踩过的那些坑。2. 环境准备与项目初始化搭建稳固的地基在开始写任何一行网络代码之前一个干净、正确的项目环境至关重要。很多稀奇古怪的错误都源于第一步没走对。2.1 创建项目与导入Mirror首先打开Unity Hub创建一个全新的3D核心模板项目。项目名称随意比如“MirrorBasics”。创建完成后不要急着做别的我们先导入Mirror。最推荐的方式是通过Unity的Package Manager从Git URL添加。点击菜单栏Window Package Manager在窗口左上角点击“”号选择“Add package from git URL...”。在弹出的输入框中粘贴Mirror在GitHub上的最新稳定版URL。你可以去Mirror的GitHub仓库通常搜索“Mirror Networking”就能找到查看最新的发布版本使用类似https://github.com/vis2k/Mirror.git?path/Assets这样的地址。这种方式能确保你获取到的是未经修改的官方源码便于后续排查问题和更新。注意不建议从Asset Store或其他第三方渠道下载打包好的Mirror版本可能滞后且可能包含未知的修改。直接从Git仓库导入是最纯净的方式。导入过程可能会花费一两分钟成功后你会在Project窗口的Assets文件夹里看到一个名为“Mirror”的文件夹。同时菜单栏会多出一个“Mirror”选项。这时你可以检查一下Package ManagerMirror应该已经出现在“My Registries”或“In Project”列表里了。2.2 关键组件初识Network Manager与场景设置导入Mirror后第一个要认识的核心组件是Network Manager。它是整个Mirror多人游戏的“大脑”和“调度中心”。我们不需要自己从头写一个Mirror提供了现成的预制件。在Project窗口中找到Assets/Mirror/Examples/文件夹里面有很多官方示例。我们先找一个最简单的比如“Basic”或“Tanks”将其中的场景打开看看。不过对于我们的基础教程我建议你亲手创建一个。回到你自己的空场景SampleScene。在Hierarchy中右键选择Create Empty将这个空物体命名为“NetworkManager”。然后选中它在Inspector面板点击“Add Component”搜索并添加Network Manager组件。你还会需要另一个组件KCP Transport或Telepathy Transport。Transport是传输层负责处理底层的网络数据包。KCP是一个快速可靠的协议适合大多数情况Telepathy更简单轻量。我们选择KCP Transport同样通过Add Component添加。现在你的NetworkManager物体上应该有两个组件Network Manager和KCP Transport。我们需要对Network Manager进行一些基本配置。在它的Inspector面板中你会看到很多字段Offline Scene / Online Scene: 分别填写你的离线如主菜单和在线游戏主场景场景的名字。我们先都填当前场景的名字如“SampleScene”。Player Prefab: 这是最重要的设置之一。它定义了当玩家加入游戏时会在场景中生成什么样的预制件作为他的角色。我们先留空后面会创建。Spawn Info: 这里可以预置一些游戏开始后需要由服务器统一生成的对象列表比如地图上的物品、NPC。完成这些后将这个配置好的NetworkManager物体拖到Project窗口的Assets文件夹里保存为一个Prefab预制件。这样以后在任何场景中你都可以直接拖入这个预制件来获得一个配置好的网络管理器保证了配置的一致性。3. 核心概念与脚本编写理解权威与同步多人游戏编程和单机游戏一个最根本的思维转变在于你需要时刻思考“这个操作由谁执行这个数据谁说了算”3.1 NetworkIdentity与NetworkBehaviour对象的“身份证”和“能力”在Mirror中任何一个需要在网络上存在的GameObject都必须挂载NetworkIdentity组件。你可以把它理解为这个物体在网络世界里的“身份证”。有了它Mirror才能唯一地识别和管理这个对象。而NetworkBehaviour是一个基类你需要让你自己编写的、包含网络逻辑的脚本继承自它而不是默认的MonoBehaviour。继承自NetworkBehaviour的脚本会自动获得一系列强大的网络相关属性和方法。让我们创建一个最简单的玩家角色。首先在场景中创建一个Cube或一个胶囊体Capsule命名为“Player”。然后为它添加NetworkIdentity组件。接着我们创建一个C#脚本命名为PlayerController。打开脚本将基类从MonoBehaviour改为NetworkBehaviour。using Mirror; using UnityEngine; public class PlayerController : NetworkBehaviour { public float moveSpeed 5f; void Update() { // 关键只有本地玩家才能控制这个角色 if (!isLocalPlayer) return; float h Input.GetAxis(Horizontal); float v Input.GetAxis(Vertical); Vector3 movement new Vector3(h, 0, v) * moveSpeed * Time.deltaTime; transform.Translate(movement); } }注意if (!isLocalPlayer) return;这行代码。这是多人游戏脚本的“黄金法则”。isLocalPlayer是NetworkBehaviour提供的一个属性只有当这个脚本实例运行在“属于当前客户端”的那个玩家对象上时它才为true。这行代码确保了每个客户端只处理自己角色的输入而不会错误地去移动其他玩家的角色。其他玩家的移动将由Mirror通过状态同步自动更新到你的机器上。将这个PlayerController脚本挂载到刚才的Player物体上。现在这个Player物体带有NetworkIdentity和你的脚本就是一个“网络预制件”的雏形。把它从Hierarchy拖到Project的Assets中保存为一个Prefab命名为“PlayerPrefab”。然后回到之前创建的NetworkManager预制件在Inspector中找到Player Prefab字段将这个PlayerPrefab拖拽赋值进去。3.2 [Command] 与 [ClientRpc]跨越客户端的指令isLocalPlayer解决了本地控制的问题但很多游戏行为需要从客户端发起最终由服务器来裁决和执行再广播给所有客户端。比如玩家开枪、使用技能、拾取物品。这就需要用到[Command]和[ClientRpc]。[Command]: 这是一个“由客户端调用在服务器上执行”的方法。想象一下你客户端向服务器发送了一个“请求开枪”的指令。只有标记了[Command]的方法才能被客户端调用通常以Cmd为前缀命名并且它会在拥有此对象的服务器实例上运行。[ClientRpc]: 这是一个“由服务器调用在所有客户端上执行”的方法。当服务器处理完一个Command比如确认子弹命中它需要告诉所有客户端“更新画面显示命中效果”。标记了[ClientRpc]的方法通常以Rpc为前缀命名就会被服务器调用并在所有连接的客户端上触发。让我们为玩家添加一个简单的“跳跃”功能这个功能需要服务器验证。public class PlayerController : NetworkBehaviour { // ... 之前的移动代码 ... void Update() { if (!isLocalPlayer) return; // 移动逻辑... float h Input.GetAxis(Horizontal); float v Input.GetAxis(Vertical); Vector3 movement new Vector3(h, 0, v) * moveSpeed * Time.deltaTime; transform.Translate(movement); // 检测跳跃输入 if (Input.GetButtonDown(Jump)) { CmdRequestJump(); // 客户端调用Command } } [Command] // 这个函数在客户端调用在服务器上运行 void CmdRequestJump() { // 服务器可以在这里进行验证比如检查玩家是否在地面上 // 这里我们简单处理直接执行跳跃逻辑 RpcPerformJump(); // 服务器调用Rpc通知所有客户端 } [ClientRpc] // 这个函数在服务器调用在所有客户端运行 void RpcPerformJump() { // 实际的跳跃视觉效果如播放动画、施加力在这里执行 // 因为它在所有客户端运行所以大家都能看到这个玩家跳起来了 GetComponentRigidbody().AddForce(Vector3.up * 5f, ForceMode.Impulse); Debug.Log(gameObject.name jumped!); } }这个流程是本地玩家按下空格 - 调用CmdRequestJump- 该命令在服务器上执行 - 服务器调用RpcPerformJump- 所有客户端包括操作者自己的该玩家物体都执行跳跃动作。实操心得在设计Command时一定要有“服务器是权威”的意识。客户端发送的Command只是一个“请求”所有重要的逻辑判断是否命中、伤害计算、物品所有权都必须在Command方法内即服务器端完成。客户端只负责发送意图和表现效果。这是防止外挂作弊的第一道防线。3.3 [SyncVar]自动同步的变量对于一些需要频繁同步的简单状态比如玩家的血量、分数、队伍颜色使用Command/Rpc来回通信有点大材小用。这时[SyncVar]属性就派上用场了。将一个公共变量标记为[SyncVar]当它在服务器上改变时Mirror会自动将新值同步给所有客户端。public class PlayerController : NetworkBehaviour { [SyncVar] public int playerHealth 100; [SyncVar(hook nameof(OnPlayerNameChanged))] public string playerName Player; void OnPlayerNameChanged(string oldName, string newName) { Debug.Log($Player name changed from {oldName} to {newName}); // 这里可以更新UI上的名字显示 } [Command] void CmdTakeDamage(int damage) { // 服务器权威地计算伤害 playerHealth - damage; if (playerHealth 0) { RpcRespawn(); } } }[SyncVar]非常高效但要注意只有服务器端修改[SyncVar]变量才会触发同步。客户端修改是无效的不会报错但不会同步给别人。可以使用hook参数指定一个回调函数。当变量同步到客户端时这个函数会被调用非常适合用来更新UI或触发视觉效果。如上面例子中的OnPlayerNameChanged。[SyncVar]同步的时机是在下一个同步帧不是立即的所以对实时性要求极高的状态如每帧变化的位置还是要用后面提到的NetworkTransform。4. 网络物体的生成与同步让世界动起来玩家角色只是网络物体的一种。游戏中的子弹、怪物、可拾取物品等都需要被网络管理起来。4.1 生成非玩家物体服务器需要负责生成所有客户端都能看到的物体。我们创建一个“子弹”预制件。创建一个Sphere命名为“Bullet”。添加NetworkIdentity组件。创建一个脚本Bullet.cs继承自NetworkBehaviour。添加简单的移动和碰撞销毁逻辑。将脚本挂到Bullet上做成预制件“BulletPrefab”。现在如何在玩家开枪时生成这颗子弹我们需要在PlayerController的Command中让服务器来生成。public class PlayerController : NetworkBehaviour { public GameObject bulletPrefab; // 在Inspector中拖入BulletPrefab public Transform firePoint; // 子弹生成点 void Update() { if (!isLocalPlayer) return; if (Input.GetMouseButtonDown(0)) { CmdFire(); } } [Command] void CmdFire() { // 服务器端生成子弹 GameObject bullet Instantiate(bulletPrefab, firePoint.position, firePoint.rotation); // 关键生成后必须调用NetworkServer.Spawn将物体纳入网络管理 NetworkServer.Spawn(bullet, connectionToClient); // 可选的为子弹添加一个力或速度这个逻辑应该在Bullet脚本的Start或OnStartServer中处理 } }NetworkServer.Spawn(object)是告诉Mirror“这个物体现在是一个网络物体了请把它同步给所有客户端。” 参数connectionToClient是可选的用于指定这个物体的“拥有者”。这里传入后这颗子弹就归属于发射它的玩家在一些权限判断时有用。4.2 使用NetworkTransform同步位置你可能会发现上面生成的子弹虽然在每个客户端都出现了但它的位置不会自动同步。为了让物体的Transform位置、旋转、缩放自动同步我们需要NetworkTransform组件。给“BulletPrefab”添加NetworkTransform组件。这个组件会定期可配置将物体的Transform信息从服务器同步到所有客户端。对于子弹这种高速移动的物体你可能需要调整NetworkTransform上的syncInterval同步间隔来获得更平滑的效果但要注意网络带宽消耗。对于玩家角色我们之前用transform.Translate移动这只是在本地修改。为了让其他客户端看到你移动你有两个选择继续使用NetworkTransform组件最简单。给PlayerPrefab也加上NetworkTransform这样你本地移动后NetworkTransform会自动将新位置同步出去。使用更权威的服务器移动。在Command中发送移动输入由服务器计算新位置再通过[SyncVar]或Rpc同步回来。这更安全但更复杂延迟也更明显。对于基础教程第一种方式更合适。注意事项NetworkTransform是“状态同步”它同步的是结果。对于高速移动的物体客户端会看到物体“瞬移”到新的同步位置。为了平滑NetworkTransform内置了插值Interpolation功能它会根据过去的位置数据在客户端上平滑地移动到最新位置。通常保持默认开启即可。如果你的游戏需要极致的操作手感如竞技FPS可能需要自己实现基于输入的预测和调和这属于高级话题。5. 游戏流程与房间管理从连接到开始游戏一个完整的多人游戏demo需要处理连接、断开、玩家准备、游戏开始等流程。5.1 启动主机与连接NetworkManager已经为我们封装了最基础的网络操作。在场景中放入NetworkManager预制件后我们可以创建简单的UI按钮来调用它。创建两个UI Button一个文本“Host (Server Client)”一个文本“Client”。为它们添加点击事件Host按钮调用NetworkManager.singleton.StartHost()。这个方法会同时启动一个服务器Server和一个本地客户端Local Client。Client按钮调用NetworkManager.singleton.StartClient()。这个方法会启动一个客户端并尝试连接到NetworkManager中设置的网络地址默认是localhost。你可以在NetworkManager组件的Inspector里设置服务器地址Network Address和端口Port。对于本地测试用localhost或127.0.0.1即可。5.2 简单的玩家准备与游戏开始逻辑通常我们需要一个“准备大厅”等所有玩家都准备就绪后再由主机服务器开始游戏。这需要一些自定义的网络逻辑。我们可以创建一个新的GameObject挂载一个继承自NetworkBehaviour的脚本比如GameLobbyManager。这个脚本只存在于服务器和每个客户端一份通过Network Identity。我们用它来管理游戏状态。using Mirror; using UnityEngine; using UnityEngine.UI; public class GameLobbyManager : NetworkBehaviour { // 用一个SyncVar来同步所有玩家是否准备就绪 [SyncVar(hook nameof(OnAllPlayersReadyChanged))] private bool allPlayersReady false; // 服务器上记录每个连接的准备状态 private System.Collections.Generic.DictionaryNetworkConnection, bool playerReadyStates new System.Collections.Generic.DictionaryNetworkConnection, bool(); // 当玩家加入时服务器端会调用这个函数需要在别处注册回调如NetworkManager的OnServerAddPlayer事件 public void OnServerAddPlayer(NetworkConnectionToClient conn) { playerReadyStates[conn] false; UpdateAllPlayersReadyState(); } // 玩家点击准备按钮客户端调用 [Command(requiresAuthority false)] // 允许无Authority的客户端调用 public void CmdPlayerReady(NetworkConnectionToClient sender null) { if (sender ! null playerReadyStates.ContainsKey(sender)) { playerReadyStates[sender] true; Debug.Log($Player {sender.connectionId} is ready.); UpdateAllPlayersReadyState(); } } // 更新并检查是否所有人都准备好了 void UpdateAllPlayersReadyState() { bool allReady true; foreach (var state in playerReadyStates.Values) { if (!state) { allReady false; break; } } allPlayersReady allReady; } // 当allPlayersReady变化时在所有客户端触发 void OnAllPlayersReadyChanged(bool oldValue, bool newValue) { if (newValue) { Debug.Log(All players are ready! Can start game.); // 这里可以显示一个“开始游戏”的按钮仅对主机可见 // 或者直接倒计时后自动开始 } } // 主机服务器调用开始游戏逻辑如切换场景 [Command(requiresAuthority false)] public void CmdStartGame() { if (allPlayersReady) { // 通知所有客户端游戏开始切换场景等 RpcLoadGameScene(); } } [ClientRpc] void RpcLoadGameScene() { // 使用NetworkManager加载在线场景确保网络状态正确迁移 NetworkManager.singleton.ServerChangeScene(GameplayScene); } }这个例子展示了如何结合[SyncVar]、[Command]和[ClientRpc]来构建一个简单的游戏流程管理器。你需要将这个脚本挂载的物体做成网络预制件并在游戏初始场景中通过NetworkServer.Spawn生成它或者将其注册到NetworkManager的“Registered Spawnable Prefabs”列表中并在场景中提前放置需有NetworkIdentity。6. 常见问题与调试技巧实录在实际开发中你会遇到各种各样的问题。这里记录几个最常见的问题和我的排查思路。6.1 连接失败与超时症状客户端无法连接到主机一直卡在连接中或直接失败。排查检查地址和端口确认客户端连接的IP地址和端口号与服务器监听的完全一致。局域网内使用本地IP如192.168.x.x本地测试用localhost。确保防火墙没有阻止Unity或对应端口。检查Transport组件确保服务器和客户端的GameObject上都有相同类型的Transport组件如都是KCP Transport且配置如端口匹配。查看控制台日志Mirror和Transport组件如KCP会输出详细的日志。在Unity Editor中注意Console窗口的日志级别选择“Verbose”或“Info”能看到更多连接握手信息。主机模式测试先尝试用StartHost()在单台机器上运行。如果主机模式正常但分离的客户端连接失败问题很可能在网络配置或防火墙。6.2 Command或Rpc不执行症状客户端点击按钮Command似乎没被调用服务器调用了Rpc客户端没反应。排查命名与调用方式Command方法必须以Cmd开头Rpc以Rpc开头。这是Mirror的硬性约定。调用Command时确保是从一个本地玩家对象isLocalPlayer为true或有Authority的对象上调用。参数序列化Command和Rpc方法的参数必须是Mirror支持的可序列化类型基本类型、Unity内置类型如Vector3、自定义结构体或类若标记了[System.Serializable]。传递一个复杂的MonoBehaviour引用会导致失败。权限检查检查Command上的requiresAuthority属性。如果你的Command允许无Authority的客户端调用比如大厅中的准备按钮需要显式设置为[Command(requiresAuthority false)]并且通常需要将NetworkConnectionToClient作为参数传入以识别调用者。网络状态确保调用Command时客户端已经成功连接到服务器并完成了玩家生成。在Start()或Awake()中调用Command通常会失败因为网络身份可能还未就绪。推荐在OnStartLocalPlayer()生命周期方法之后进行网络调用。6.3 物体不同步或位置抖动症状其他玩家看到的物体位置不对或者移动时一顿一顿的。排查NetworkIdentity和NetworkTransform确认所有需要同步的物体都有NetworkIdentity组件。对于需要同步位置/旋转的物体添加NetworkTransform组件。插值与同步速率NetworkTransform的syncInterval默认是0.1秒10次/秒。对于快速移动的物体如子弹、赛车可以尝试减小这个值如0.05秒但会增加带宽。同时确保Interpolation插值是开启的这会让移动更平滑。在服务器端移动如果物体是由服务器权威移动的比如NPC确保移动逻辑写在NetworkBehaviour的Update或FixedUpdate中并且没有被isLocalPlayer条件包裹。服务器端的物体isLocalPlayer永远是false。网络延迟这是固有的。Mirror的NetworkTransform使用快照插值来对抗延迟。如果抖动严重可以检查网络延迟Ping。在NetworkTransform组件上可以适当增加interpolationBackTime插值回溯时间给客户端更多的时间来缓冲和插值但这会增加显示延迟。6.4 错误“Spawn object not found”症状服务器尝试生成一个物体时客户端报错找不到预制件。排查注册预制件任何需要通过NetworkServer.Spawn动态生成的预制件都必须提前注册到NetworkManager中。在NetworkManager组件的Inspector面板找到 “Spawn Info” 折叠栏将你的预制件如BulletPrefab, EnemyPrefab拖入 “Registered Spawnable Prefabs” 列表。预制件一致性确保服务器和客户端工程中的预制件具有相同的名称和GUID通常意味着是同一个预制件文件。如果客户端没有这个预制件就无法实例化。生成时机确保在调用NetworkServer.Spawn之前物体已经被Instantiate了。调试网络游戏一个非常有效的方法是使用Unity Editor的“ParrelSync”工具可在GitHub找到。它允许你同时打开多个独立的Unity Editor实例模拟多个客户端并且项目资产是同步的极大方便了本地测试和调试。另一个笨办法但有效的方法是“Build and Run”一个客户端然后用Editor作为服务器或另一个客户端进行连接测试这样能发现一些只在独立运行时才出现的问题。最后保持耐心。多人游戏开发就是与状态同步、延迟和不确定性作斗争的过程。从这个小demo开始理解每一个基础概念然后逐步增加复杂度你会发现Mirror这个工具能帮你屏蔽很多底层烦恼让你更专注于游戏玩法本身的实现。当你第一次看到两个方块在同一个场景里由不同电脑控制着移动时那种成就感绝对是单机开发无法比拟的。
![[C++]内存管理：串顺序存储的内存回收](http://pic.xiahunao.cn/yaotu/[C++]内存管理：串顺序存储的内存回收)
