目錄

一、使用介紹

二、插件介紹

1、簡述

2、核心功能與特點

基于組件的高層抽象

服務(wù)器-客戶端架構(gòu)

序列化與同步

可擴展性與靈活性

跨平臺支持

社區(qū)與生態(tài)

3、典型應(yīng)用場景

4、基本使用示例

安裝

設(shè)置 NetworkManager

同步變量與 RPC

5、優(yōu)缺點對比

6、為什么選擇 Mirror？

7、常見問題

1???檢查 Unity 版本

2?? ?通過 Package Manager 安裝依賴

3?? ?手動修改?manifest.json

4?? ?驗證依賴是否加載

---

一、使用介紹

插件來源：Unity?AssetStore

（Mirror | 網(wǎng)絡(luò) | Unity Asset Store）

Github：GitHub - MirrorNetworking/Mirror: #1 Open Source Unity Networking Library

官方網(wǎng)頁：Mirror Networking – Open Source Networking for Unity

官方文檔：Mirror Networking | Mirror

使用版本：Unity 2022.3.53f1c1、Mirror 96.0.1

---

二、插件介紹

1、簡述

Unity Mirror 是一個專為 Unity 引擎設(shè)計的開源、社區(qū)驅(qū)動的網(wǎng)絡(luò)庫，主要用于簡化多人聯(lián)機游戲的開發(fā)。它最初是為了替代 Unity 原生的 UNet 系統(tǒng)（已被官方棄用）而創(chuàng)建的，因其輕量、靈活和高效的特點，成為 Unity 開發(fā)者構(gòu)建多人游戲的熱門選擇。

---

2、核心功能與特點

基于組件的高層抽象

1. Mirror 提供了?NetworkManager、NetworkIdentity、NetworkBehaviour?等組件，開發(fā)者只需通過繼承和配置這些組件，即可快速實現(xiàn)網(wǎng)絡(luò)同步邏輯，無需深入底層協(xié)議細節(jié)。

服務(wù)器-客戶端架構(gòu)

1. 支持權(quán)威服務(wù)器模式（服務(wù)器控制邏輯，客戶端僅負責(zé)輸入和渲染）。
2. 提供?NetworkServer?和?NetworkClient?類，管理連接、消息處理和對象同步。
3. 支持 LAN 和互聯(lián)網(wǎng)聯(lián)機，可通過 Relay 服務(wù)器（如 Steam）實現(xiàn) NAT 穿透。

序列化與同步

1. 變量同步：通過?[SyncVar]?屬性標記變量，自動將狀態(tài)從服務(wù)器同步到客戶端。
2. 指令同步：使用?[Command]（客戶端調(diào)用服務(wù)器方法）和?[ClientRpc]（服務(wù)器調(diào)用客戶端方法）實現(xiàn)遠程過程調(diào)用（RPC）。
3. Transform 同步：內(nèi)置?NetworkTransform?組件自動同步物體位置、旋轉(zhuǎn)和縮放。

可擴展性與靈活性

1. 支持自定義序列化、消息類型和網(wǎng)絡(luò)傳輸層（如 TCP、UDP、WebSockets）。
2. 允許開發(fā)者覆蓋默認行為（如連接認證、對象生成規(guī)則）。

跨平臺支持

1. 兼容 Unity 支持的幾乎所有平臺（PC、移動端、主機、WebGL 等）。

社區(qū)與生態(tài)

1. 豐富的文檔和示例項目（如多人射擊、RPG、實時策略模板）。
2. 活躍的 Discord 社區(qū)和 GitHub 倉庫，便于問題解決和功能討論。
3. 與常用插件（如 FishNet、Lobby 系統(tǒng)）兼容。

---

3、典型應(yīng)用場景

• 多人聯(lián)機游戲（PvP、PvE、合作模式）

• 實時同步應(yīng)用（如虛擬會議、協(xié)作工具）

• 原型快速開發(fā)（無需從零實現(xiàn)網(wǎng)絡(luò)邏輯）

---

4、基本使用示例

安裝

通過 Unity Package Manager 或 GitHub 倉庫導(dǎo)入 Mirror。

導(dǎo)入Mirror插件資源

設(shè)置 NetworkManager

// 創(chuàng)建 NetworkManager 對象并配置服務(wù)器地址、端口和玩家預(yù)制體。
public class MyNetworkManager : NetworkManager {public override void OnServerAddPlayer(NetworkConnection conn) {GameObject player = Instantiate(playerPrefab);NetworkServer.AddPlayerForConnection(conn, player);}
}

同步變量與 RPC

public class Player : NetworkBehaviour {[SyncVar]public int health = 100;[Command]public void CmdTakeDamage(int damage) {health -= damage;}[ClientRpc]public void RpcRespawn() {transform.position = Vector3.zero;}
}

---

5、優(yōu)缺點對比

優(yōu)點	缺點
開源免費，社區(qū)支持強大	需要自行處理復(fù)雜同步邏輯（如預(yù)測與插值）
學(xué)習(xí)曲線較低（相比底層 Socket）	大型項目需優(yōu)化網(wǎng)絡(luò)流量
高度可定制化	依賴 Unity 的更新兼容性

---

6、為什么選擇 Mirror？

• UNet 的繼承者：Unity 已棄用 UNet，Mirror 是社區(qū)維護的最佳替代方案。

• 輕量高效：相比 Photon 等第三方服務(wù)，Mirror 提供更多控制權(quán)且無額外成本。

• 適合中小團隊：快速實現(xiàn)多人功能，無需深厚網(wǎng)絡(luò)編程經(jīng)驗。

7、常見問題

導(dǎo)入 Unity 資源包時遇到的錯誤提示 ?"This Asset Package has Unity Package Manager dependencies"?意味著該資源包依賴兩個特定的 UPM（Unity Package Manager）包：com.unity.ugui@2.0.0?和?com.unity.nuget.newtonsoft-json@3.0.0。

---

解決方法：

1???檢查 Unity 版本

• 確保你使用的 Unity 版本與資源包兼容。
• com.unity.ugui@2.0.0?通常對應(yīng) ?Unity 2020.3+，舊版本可能無法支持。

---

2?? ?通過 Package Manager 安裝依賴

1. 打開 Unity Editor，進入頂部菜單：
   ?Window > Package Manager
2. 在 Package Manager 窗口中：
   • 確保選擇 ?Unity Registry? 作為包源。
3. 搜索并安裝以下包：
   • ?**"Unity UI" (com.unity.ugui)**?
     • 確保版本為?2.0.0（可能需要升級 Unity）。
   • ?**"Newtonsoft Json" (com.unity.nuget.newtonsoft-json)**?
     • 安裝?3.0.0?版本。

---

3?? ?手動修改?manifest.json

如果包管理器中沒有找到指定版本，可手動添加依賴：

1. 打開項目目錄：YourProject/Packages/manifest.json
2. 在?dependencies?部分添加以下內(nèi)容：

   {"dependencies": {"com.unity.ugui": "2.0.0","com.unity.nuget.newtonsoft-json": "3.0.0",// 其他依賴...}
   }

3. 保存文件，重啟 Unity Editor。

---

4?? ?驗證依賴是否加載

• 重啟 Unity 后，檢查 ?Package Manager? 中是否已正確加載這兩個包。
• 如果出現(xiàn)版本沖突，嘗試刪除項目目錄下的?Library?文件夾并重新導(dǎo)入資源包。