如果你正在为 Unity 联机开发而头疼面对网络同步的延迟、卡顿和复杂的底层代码感到无从下手那么这篇文章就是为你准备的。很多开发者尝试过 Unity 自带的 UNet已弃用、Mirror甚至自己用 Socket 硬撸但往往在实现“高丝滑、低延迟”的体验时会遇到同步抖动、断线重连、房间管理等一系列工程难题。Photon Unity Networking (PUN) 并不是一个新鲜事物但它之所以在众多联机方案中依然被广泛使用尤其是在中小型团队和独立开发者中核心原因在于它提供了一个“开箱即用”的托管式网络层。你不需要自己搭建服务器、处理底层协议就能快速获得一个稳定、可扩展的多人游戏框架。本文的核心判断是对于大多数追求快速上线、稳定体验的 Unity 联机项目PUN 是目前综合成本时间成本技术成本最低的可靠选择之一。它真正解决的不是“能不能联机”的问题而是“如何以可控的复杂度实现一个手感流畅、易于维护的联机功能”。读完本文你将能清晰地掌握Photon PUN 的核心工作流、如何从零搭建一个基础的多人同步场景、实现玩家移动和基础交互并理解其背后的同步原理与关键配置。更重要的是你会知道如何规避那些导致延迟增高、同步卡顿的常见“坑”以及如何为你的项目选择最合适的 Photon 方案。1. 为什么选择 Photon不仅仅是“不用自建服务器”在深入代码之前我们需要先理清一个关键问题市面上联机方案那么多为什么是 Photon这决定了你是否应该继续往下读。1.1 核心优势托管服务与状态同步Photon 的核心价值在于其 Cloud 服务。你无需购买物理服务器、配置网络环境、编写复杂的服务端逻辑来处理连接、房间和匹配。Photon Cloud 帮你托管了这一切你只需要关心客户端即 Unity 游戏内的逻辑。它采用了一种称为“权威客户端Authoritative Client”或“状态同步State Synchronization”的模型。简单来说每个客户端控制自己的游戏对象并将这个对象的状态位置、旋转、血量等定期发送给服务器服务器再转发给其他所有客户端。这种方式非常适合动作类、实时性要求高的游戏。1.2 与其它方案的对比为了更直观我们通过一个表格来对比几种常见方案方案优点缺点适用场景Photon PUN快速集成文档丰富Cloud托管内置房间/匹配低延迟优化好。有并发和CCU限制免费版有上限深度定制服务端逻辑较复杂。中小型实时多人游戏FPS、动作、休闲竞技、原型验证、独立游戏。Mirror开源免费基于UNet High-Level API演化社区活跃可自建服务器。需要自行部署和维护服务器网络编程门槛相对较高。中大型项目、需要完全控制服务器逻辑、团队有网络后端开发能力。Unity Netcode for GameObjects官方出品与Unity深度集成支持主机/客户端模式。相对较新高级功能和生态还在完善中托管服务Unity Gaming Services有学习成本。信任Unity技术栈、希望使用官方解决方案的项目。原生Socket完全控制极限优化可能。开发周期极长需要处理所有网络层问题连接、粘包、心跳、安全等维护成本高。网络底层研究、特定协议需求、超大型团队的核心项目。结论如果你的目标是快速、稳定地实现一个手感不错的联机 demo 或上线一个中小型游戏并且不希望被服务器运维拖累Photon PUN 是一个起点很低、天花板也足够高的选择。它的“丝滑”来自于其全球部署的数据中心和优化的网络协议而“低延迟”则需要你正确地使用它。2. Photon PUN 核心概念快速理解开始动手前花几分钟理解这几个关键概念能让你后面的开发事半功倍。Photon CloudPhoton 提供的托管服务器网络。你的游戏客户端连接到这里。AppId你的游戏在 Photon Cloud 的唯一标识。创建项目后获得是连接的门票。房间Room玩家进行一局游戏的基本单位。一个房间有属性名称、最大玩家数、是否可见等。玩家Player连接到房间的每个客户端实例。每个玩家有一个唯一的ActorNumber。Network Object需要在网络上同步的游戏对象。在 PUN 中通常通过给 GameObject 添加PhotonView组件来实现。PhotonView网络视图组件。它是网络对象的“眼睛”和“嘴巴”负责标识对象并定义哪些数据需要同步以及由谁哪个客户端来控制Observed Component和Ownership。RPCRemote Procedure Call远程过程调用。允许一个客户端调用另一个客户端或所有客户端对象上的方法。用于处理离散事件如开枪、聊天、使用技能。序列化Serialization将游戏对象的状态如位置、血量转换为网络消息的过程。PUN 可以自动同步 Transform也可以通过OnPhotonSerializeView方法自定义同步其他数据。最容易混淆的点Ownership所有权所有权是 PUN 同步逻辑的基石。默认情况下创建网络对象的玩家拥有该对象的所有权。只有拥有者才能直接通过修改 Transform 来同步该对象的位置如果使用自动同步。其他玩家看到的该对象位置是由拥有者客户端发出经服务器转发而来的数据。理解这一点是解决“为什么我的角色控制不跟手”或“为什么别人的角色在飘移”的关键。3. 环境准备与项目设置我们从一个纯净的 Unity 项目开始。本教程基于 Unity 2022.3 LTS 版本但 PUN 2 兼容广泛的 Unity 版本。3.1 注册 Photon 并获取 AppId访问 Photon Engine 官网 并注册账号。登录后在 Dashboard 点击 “Create a New App”。选择 “Photon PUN” 作为类型填写应用名称创建。创建成功后进入应用详情页找到 “App Id”。复制这个字符串它形如xxxx-xxxx-xxxx-xxxx-xxxx。3.2 在 Unity 中导入和配置 PUN 2在 Unity 中打开Window - Asset Store。搜索 “Photon Unity Networking 2”。点击 “Download” 然后 “Import”将插件导入项目。导入后可能会自动弹出 “Photon Setup Wizard” 窗口。如果没有可以通过Window - Photon Unity Networking - PUN Wizard打开。在 Wizard 的 “Setup” 标签页将之前复制的AppId粘贴到 “Photon Server Settings” 区域。点击 “Setup Project” 按钮。这会在你的项目Resources文件夹下创建或更新一个名为PhotonServerSettings的配置文件。至此Photon 的基础集成已经完成。这个PhotonServerSettings文件包含了连接 Photon Cloud 所需的所有配置。4. 核心流程拆解从连接到游戏一个典型的 PUN 多人游戏流程可以拆解为以下步骤我们将逐步实现连接至 Photon Cloud建立客户端与云服务的连接。加入或创建房间进入一个具体的游戏会话。玩家角色生成与同步在房间内为每个玩家实例化一个可控制的网络对象。实现玩家移动同步让所有客户端都能看到其他玩家的移动。实现基础交互如射击使用 RPC 处理瞬时事件。离开与断线处理优雅地退出房间或处理网络异常。5. 完整示例创建一个简单的多人移动与射击场景我们将创建一个场景包含一个平面作为地板玩家可以控制一个立方体移动并按下鼠标左键“射击”生成一个球体。5.1 场景与基础设置新建一个 Unity 场景添加一个 Plane 作为地面。创建一个空 GameObject命名为NetworkManager。它将作为我们管理网络连接和游戏逻辑的单例。5.2 编写网络管理器NetworkManager.cs这是游戏网络逻辑的总控脚本。// 文件路径Assets/Scripts/NetworkManager.cs using UnityEngine; using Photon.Pun; using Photon.Realtime; using System.Collections.Generic; public class NetworkManager : MonoBehaviourPunCallbacks { public static NetworkManager Instance; // 单例模式方便访问 [Header(Player Prefab)] public GameObject playerPrefab; // 需要在Inspector中指定的玩家预制体 private void Awake() { if (Instance null) { Instance this; DontDestroyOnLoad(gameObject); // 跨场景不销毁 } else { Destroy(gameObject); } } void Start() { // 启动时自动连接。确保 PhotonServerSettings 已配置好 AppId。 ConnectToPhoton(); } void ConnectToPhoton() { Debug.Log(Connecting to Photon Cloud...); // 设置玩家的游戏版本用于区分不同版本客户端防止不兼容 PhotonNetwork.GameVersion 1.0; // 开始连接流程 PhotonNetwork.ConnectUsingSettings(); } #region Photon Callbacks // 成功连接到 Photon Cloud 主服务器 public override void OnConnectedToMaster() { Debug.Log(Connected to Master Server.); // 连接成功后尝试加入一个随机房间 JoinRandomRoom(); } void JoinRandomRoom() { Debug.Log(Joining a random room...); PhotonNetwork.JoinRandomRoom(); } // 加入随机房间失败通常是因为没有房间存在 public override void OnJoinRandomFailed(short returnCode, string message) { Debug.Log(No random room available, creating a new one...); // 创建房间的参数 RoomOptions roomOptions new RoomOptions(); roomOptions.MaxPlayers 4; // 房间最大人数 roomOptions.IsVisible true; // 房间在大厅列表中可见 roomOptions.IsOpen true; // 房间可加入 PhotonNetwork.CreateRoom(null, roomOptions); // 传入 null 让服务器生成随机房间名 } // 成功创建房间后回调 public override void OnCreatedRoom() { Debug.Log(Room created successfully: PhotonNetwork.CurrentRoom.Name); } // 成功加入房间后回调包括创建后加入 public override void OnJoinedRoom() { Debug.Log(Joined room: PhotonNetwork.CurrentRoom.Name . Player count: PhotonNetwork.CurrentRoom.PlayerCount); // 在房间中生成玩家角色 SpawnPlayer(); } // 有其他玩家加入房间 public override void OnPlayerEnteredRoom(Player newPlayer) { Debug.Log($Player {newPlayer.ActorNumber} entered the room.); } // 有玩家离开房间 public override void OnPlayerLeftRoom(Player otherPlayer) { Debug.Log($Player {otherPlayer.ActorNumber} left the room.); } #endregion void SpawnPlayer() { if (playerPrefab null) { Debug.LogError(PlayerPrefab is not assigned in NetworkManager!); return; } // 生成点这里简单地在原点附近随机位置生成 Vector3 spawnPosition new Vector3(Random.Range(-3f, 3f), 1f, Random.Range(-3f, 3f)); // 使用 PhotonNetwork.Instantiate 来网络化实例化预制体 // 最后一个参数 0 是分组group一般用0即可 PhotonNetwork.Instantiate(playerPrefab.name, spawnPosition, Quaternion.identity, 0); } // 提供给UI按钮调用的方法离开房间 public void LeaveRoom() { PhotonNetwork.LeaveRoom(); } // 离开房间后的回调 public override void OnLeftRoom() { Debug.Log(Left the room.); // 离开房间后可以跳转回大厅场景或进行其他处理 // UnityEngine.SceneManagement.SceneManager.LoadScene(Lobby); } }5.3 创建玩家预制体与移动控制脚本在场景中创建一个 Cube重命名为PlayerPrefab。将其拖入Assets/Resources文件夹PUN 要求网络预制体必须放在 Resources 文件夹或其子文件夹下使其成为一个预制体。然后从场景中删除这个 Cube。选中这个预制体在 Inspector 中点击 “Add Component”添加PhotonView组件。在PhotonView组件中将Observed Components列表大小设为 1然后将该预制体上即将编写的PlayerController脚本拖入或之后拖入。这表示PlayerController脚本将负责同步这个视图的数据。为PlayerPrefab预制体创建一个新的 C# 脚本PlayerController.cs。// 文件路径Assets/Scripts/PlayerController.cs using UnityEngine; using Photon.Pun; using Photon.Realtime; public class PlayerController : MonoBehaviourPunCallbacks, IPunObservable { public float moveSpeed 5f; public GameObject bulletPrefab; // 子弹预制体需要在Inspector中指定 public Transform firePoint; // 发射点可以是一个子物体 private Vector3 smoothMovePosition; // 用于非控制角色的插值位置 private float smoothTime 0.1f; // 插值平滑时间 void Start() { // 如果是本地玩家控制的角色可以做一些特殊处理比如附加相机 if (photonView.IsMine) { Debug.Log(This is my local player.); // 将主摄像机设置为跟随此玩家简单示例 Camera.main.transform.SetParent(transform); Camera.main.transform.localPosition new Vector3(0f, 5f, -7f); Camera.main.transform.localRotation Quaternion.Euler(30f, 0f, 0f); } else { Debug.Log(This is a remote player.); // 对于远程玩家我们不需要处理输入但需要平滑同步位置 // 可以禁用本地不必要的组件如控制脚本、摄像机等 } } void Update() { // 只有这个网络对象的拥有者本地玩家才处理输入和直接移动 if (photonView.IsMine) { ProcessInputs(); } else { // 对于非本地玩家使用插值平滑地移动到接收到的位置 SmoothMovement(); } } void ProcessInputs() { float horizontal Input.GetAxis(Horizontal); float vertical Input.GetAxis(Vertical); Vector3 movement new Vector3(horizontal, 0f, vertical) * moveSpeed * Time.deltaTime; transform.Translate(movement); // 射击输入 if (Input.GetButtonDown(Fire1)) // 默认鼠标左键 { Shoot(); } } void SmoothMovement() { // 使用 Vector3.Lerp 或 SmoothDamp 平滑地移动到目标位置 transform.position Vector3.Lerp(transform.position, smoothMovePosition, Time.deltaTime * (1f / smoothTime)); } void Shoot() { // 使用 RPC 在所有客户端上生成子弹 photonView.RPC(RPC_Shoot, RpcTarget.AllViaServer, firePoint.position, firePoint.rotation); } // 这是一个 RPC 方法会在所有客户端上执行 [PunRPC] void RPC_Shoot(Vector3 position, Quaternion rotation, PhotonMessageInfo info) { // 注意这里直接实例化因为子弹本身可能也需要同步。更复杂的做法是让子弹也是网络对象。 // 为了简单演示我们只在本地生成一个非同步的子弹。 // 在实际项目中子弹通常也需要用 PhotonNetwork.Instantiate 生成。 GameObject bullet Instantiate(bulletPrefab, position, rotation); Bullet bulletScript bullet.GetComponentBullet(); if (bulletScript ! null) { // 可以设置子弹的发射者等信息 bulletScript.SetShooter(info.Sender); } // 简单添加一个向前的作用力假设子弹有Rigidbody Rigidbody rb bullet.GetComponentRigidbody(); if (rb ! null) { rb.AddForce(bullet.transform.forward * 500f); } // 5秒后销毁子弹本地 Destroy(bullet, 5f); } // IPunObservable 接口方法用于自定义同步数据 public void OnPhotonSerializeView(PhotonStream stream, PhotonMessageInfo info) { if (stream.IsWriting) { // 我们是这个对象的拥有者发送数据位置到其他客户端 stream.SendNext(transform.position); } else { // 我们是其他客户端接收数据 smoothMovePosition (Vector3)stream.ReceiveNext(); } } }5.4 创建子弹脚本与预制体创建一个 Sphere重命名为BulletPrefab添加Rigidbody组件并拖入Resources文件夹成为预制体。为子弹创建一个简单的脚本Bullet.cs。// 文件路径Assets/Scripts/Bullet.cs using UnityEngine; using Photon.Pun; using Photon.Realtime; public class Bullet : MonoBehaviour { public float damage 10f; private Player shooter; // 发射者 public void SetShooter(Player player) { shooter player; } void OnCollisionEnter(Collision collision) { // 简单的碰撞处理碰到非发射者的玩家造成伤害 PlayerController player collision.gameObject.GetComponentPlayerController(); if (player ! null shooter ! null !player.photonView.Owner.Equals(shooter)) { Debug.Log($Hit player {player.photonView.Owner.ActorNumber}!); // 这里可以调用一个 RPC 在玩家身上应用伤害 // player.photonView.RPC(TakeDamage, RpcTarget.All, damage); } // 销毁子弹本地 Destroy(gameObject); } }5.5 组装与配置回到 Unity 编辑器。将PlayerPrefab预制体从Resources文件夹拖到NetworkManager游戏对象的NetworkManager脚本的Player Prefab字段上。选中PlayerPrefab预制体在PlayerController脚本组件上将Bullet Prefab字段赋值为BulletPrefab预制体。创建一个空子物体作为Fire Point并将其拖到Fire Point字段。确保NetworkManager游戏对象在启动场景中。6. 运行测试与效果验证单机测试直接点击 Unity 播放按钮。观察 Console 日志应该会显示连接、创建/加入房间、生成玩家。你可以用 WASD 移动鼠标左键射击。但此时只有你一个玩家。多人联机测试关键步骤方法一推荐使用 Unity 的ParrelSync等工具在同一台机器上运行多个编辑器实例来模拟多个客户端。方法二构建独立应用。打开File - Build Settings将当前场景添加到 “Scenes In Build”。点击 “Build And Run”选择一个文件夹生成一个.exe文件并运行。不要关闭 Unity 编辑器再次点击 “Build And Run”但这次选择另一个文件夹或另一个文件名如Game_Client2.exe生成第二个客户端。同时运行这两个.exe文件。验证成功在两个客户端中你都会看到两个立方体玩家。控制其中一个客户端的角色移动在另一个客户端中应该能看到该角色平滑地移动。在一个客户端中按下鼠标左键射击两个客户端应该都能看到子弹被生成并飞出。查看 Unity 编辑器运行的那个客户端的 Console会看到类似Player 2 entered the room.的日志。如何判断成功两个或多个独立运行的客户端能出现在同一个场景中。每个客户端只能直接控制自己的那个立方体通过输入。其他玩家控制的立方体其移动在你的客户端上是平滑插值过来的而不是瞬移。射击动作在所有客户端上都有表现子弹生成。7. 常见问题与排查思路实现“高丝滑、低延迟”的关键以下是使用 PUN 开发时最常遇到的问题及其解决方案很多都直接影响手感和延迟。问题现象可能原因排查方式解决方案连接失败卡在Connecting to Photon Cloud...1. AppId 错误或未配置。2. 网络问题防火墙、代理。3. PhotonServerSettings 未正确生成。1. 检查 PUN Wizard 中的 AppId 是否与官网一致。2. 查看 Unity Console 的错误信息。3. 检查Resources/PhotonServerSettings文件是否存在。1. 重新复制粘贴 AppId。2. 关闭可能干扰的网络工具尝试不同网络。3. 通过 PUN Wizard 重新 “Setup Project”。玩家角色生成失败1. 预制体未放在Resources文件夹。2.PhotonNetwork.Instantiate的预制体名称错误。3. 预制体上没有PhotonView组件。1. 确认预制体路径。2. 检查Instantiate调用时传入的名称是否与预制体文件名不含后缀完全一致。3. 检查预制体 Inspector。1. 确保预制体在Resources或其子文件夹下。2. 使用playerPrefab.name或硬编码正确的字符串。3. 为预制体添加PhotonView。我的角色移动正常但其他玩家的角色移动卡顿、瞬移1.未使用插值Interpolation。直接设置transform.position会导致跳变。2. 网络发送率 (SendRate) 太低。3. 网络延迟或丢包高。1. 检查PlayerController中是否为远程玩家实现了位置插值如Lerp。2. 在PhotonNetwork设置中查看SendRate和SerializationRate。3. 运行游戏观察PhotonNetwork.NetworkStatistics。1.必须为非本地玩家角色实现插值。参考本文SmoothMovement()方法。2. 适当提高PhotonNetwork.SendRate(默认30)。在NetworkManager的Start方法中设置如PhotonNetwork.SendRate 60;。3. 优化网络环境检查代码逻辑是否在 Update 中过于频繁地发送 RPC。只有我能看到自己发射的子弹子弹的生成没有通过网络同步。在Shoot()方法中使用了Instantiate而非PhotonNetwork.Instantiate。检查Shoot和RPC_Shoot方法。Instantiate是本地生成。如果子弹需要被所有玩家看到它也必须是一个网络对象。修改RPC_Shoot使用PhotonNetwork.Instantiate生成子弹预制体并确保子弹预制体也有PhotonView。角色控制权混乱我能移动别人的角色未正确处理PhotonView的所有权 (Ownership) 和photonView.IsMine判断。在PlayerController的Update和所有输入处理逻辑前检查if (photonView.IsMine)。严格遵守规则任何直接修改网络对象 Transform 或重要状态的代码都必须包裹在if (photonView.IsMine)条件内。断线后玩家角色不消失未处理玩家离开房间后的网络对象清理。玩家离开后其控制的网络对象默认不会自动销毁。在NetworkManager的OnPlayerLeftRoom回调中可以遍历场景中的网络对象找到属于离开玩家的对象并销毁。更简单的做法是在玩家预制体上挂载一个脚本在OnDestroy或OnDisable时调用PhotonNetwork.Destroy(gameObject)。PUN 通常会自动清理所有者离开的对象但自定义逻辑需注意。8. 最佳实践与工程建议要实现“高丝滑、低延迟”除了解决上述问题还需要遵循以下工程实践8.1 网络数据优化只同步必要数据在OnPhotonSerializeView中只发送变化且关键的数据。避免每帧同步大量不变的或可推算的数据。使用合适的压缩对于Vector3、Quaternion可以考虑使用PhotonNetwork.SerializationRate和自定义压缩。对于 float如果精度要求不高可以压缩为short或byte。区分可靠与不可靠传输移动位置更新通常使用不可靠但快速的 UDP关键事件如死亡、得分使用可靠的 RPC (RpcTarget.AllViaServer或RpcTarget.All)。8.2 客户端预测与插值客户端预测对于本地玩家的移动可以立即应用输入并移动然后将状态发送给服务器。即使有轻微延迟本地操作也是即时的。服务器负责权威验证和纠正防作弊但反馈可以稍有延迟。PUN 本身不提供高级预测需要自己实现或使用更高级的框架如 Fusion。插值Interpolation对于远程实体永远不要直接将其位置设置为接收到的网络位置。应该将网络位置存储为一个目标位置然后在Update中使用Vector3.Lerp或Vector3.SmoothDamp平滑地移动过去。本文示例中的smoothMovePosition就是用于此目的。外推Extrapolation在丢包或延迟波动时可以根据最后已知的速度和方向短暂预测远程实体的位置等新数据到达后再纠正。实现复杂度较高。8.3 房间与匹配策略使用房间属性利用Room.CustomProperties来存储房间状态如地图、模式、回合数便于大厅筛选和同步。实现简单的大厅 UI使用PhotonNetwork.JoinLobby()后可以通过OnRoomListUpdate回调获取房间列表并显示给玩家选择。考虑区域在PhotonServerSettings中设置最佳区域如eu,us,asia让玩家连接到物理距离最近的服务器这是降低延迟最有效的方法之一。8.4 错误处理与健壮性监听断线回调重写OnDisconnected(DisconnectCause cause)方法根据不同的cause如超时、被踢、异常给玩家友好的提示并尝试重连或返回主菜单。使用PhotonNetwork.IsConnectedAndReady在执行任何网络操作前检查此属性避免在断线或未准备好时调用 API 导致异常。日志与监控在开发阶段充分利用PhotonNetwork.NetworkStatistics来监控往返时间、丢包率等关键指标。8.5 项目结构建议单一网络管理器使用一个全局的NetworkManager单例来处理连接、房间逻辑。分离逻辑与表现网络脚本只负责数据的发送、接收和权威状态的维护。视觉表现动画、特效应放在独立的脚本中根据网络状态进行更新。预制体管理将所有网络预制体集中放在Resources/Prefabs/等目录下便于管理和PhotonNetwork.Instantiate调用。通过以上步骤和最佳实践你不仅能够搭建一个可运行的 Photon PUN 联机 demo更能理解其内部运作机制从而有能力去构建更复杂、更流畅的多人游戏体验。记住网络编程是一个权衡的艺术在延迟、带宽、一致性和开发复杂度之间找到适合你项目的平衡点才是通往“高丝滑、低延迟”的真正路径。