※細節說明與完整教學皆以官方文檔為準,此頁僅作總覽。
OxGFrame 是基於 Unity 用於加快遊戲開發的框架,並且使用 UniTask 進行異步處理,從資源加載 (AssetLoader)、遊戲介面 (UIFrame)、場景資源 (SRFrame)、Unity 場景 (USFrame)、模板物件 (CPFrame)、音樂音效 (AudioFrame)、影片 (VideoFrame)、遊戲階段整合 (GSIFrame)、網路 (NetFrame)、事件中心 (CenterFrame),能夠簡單入手與有效的加快開發效率,並且支持多平台 Win、OSX、Android、iOS、WebGL (皆通過測試)。
WebGL_BundleDemo.mp4
相關模板建立的選單 (Create menu items)
- 最低支援 Unity 2021.3 (LTS)
- 建議使用 Unity 2022.3 (LTS) or higher - Unity Download
- 已驗證版本:Unity 2022.3、Unity 6.3 (6000.3)
- 同時相容 YooAsset 2.x 與 YooAsset 3.x,依安裝版本自動定義
YOOASSET_2/YOOASSET_3切換代碼 (Assembly Version Defines)。 - 已驗證版本:2.3.18、2.3.19、3.0.3-beta、3.0.4、3.0.5 (建議使用 3.0.5+)。
- ※注意 : v2 與 v3 建置的 Bundle 互不相容,切換版本後需重新建置資源。
代碼熱修復模塊,集成 HybridCLR 革命性熱更新方案 (相關建置請參考 HybridCLR 官方文檔)。建置完成後,可透過選單 HybridCLR/OxGFrame With HybridCLR/Compile And Copy To HotfixCollector 一鍵編譯拷貝熱更 DLL,再由 YooAsset Collector 收集打包 (使用流程詳見 HotfixerDemo)。
※備註 : 運行打包 HotfixerDemo 需要 Import PatchLauncher from PackageManager
資源加載器模塊,支援動態 Async 或 Sync 加載與計數管理 (Resources 與 AssetBundle 成對 Load & Unload)。AssetBundle 集成 YooAsset 實現資源熱更新方案,支援 App 與 DLC 分包管理 (PackageOperation)、群組分包下載、磁碟空間檢查、下載途中直接修復,並實現 YooAsset 加解密介面:Offset、XOR、HT2XOR、HT2XOR-Plus、AES、ChaCha20、XXTEA、OffsetXOR (加解密效率比較)。
- ※備註 : Use "res#" will load from Resources else load from Bundle
- ※提醒 : 使用 Bundle 開發時,需先將 PatchLauncher 拖曳至場景中 (透過 Samples Import PatchLauncher Prefab)
OxGFrame_BundleDemo.mp4
OxGFrame_BundleDLCDemo.mp4
核心模塊 (連動 AssetLoader 實現自動卸載),實現物件命名綁定與代碼自動生成 (綁定 Hotkey: Shift+B、停止標籤 Hotkey: Shift+E)。
- UIFrame : UI Prefab 調度 (UGUI),支援 UI 反切 (Reverse Changes)、堆疊關閉 (Close Stack By Stack)、隱藏凍結與遮罩事件 (綁定使用 _Node@XXX)。
- SRFrame : 場景資源 Prefab 調度 (綁定使用 _Node@XXX)。
- USFrame : Unity 場景調度 (支援 AssetBundle)。※備註 : Use "build#" will load scene from Build else load scene from Bundle
- CPFrame : 模板物件實例調度,直接 GameObject.Destroy 即自動卸載 (綁定使用 ~Node@XXX)。
| UI 反切運用 (Reverse Changes) | UI 反切運用 (Reverse Changes) |
|---|---|
![]() |
![]() |
| UI 堆疊關閉運用 (Close Stack By Stack) | UI 堆疊關閉運用 (Close Stack By Stack) |
|---|---|
![]() |
![]() |
綁定說明
綁定配置
自動生成停止綁定標籤 (Hotkey: Shift+E)
自動生成物件綁定代碼 (Hotkey: Shift+B) - 自動 (Auto)
OxGFrame_AutoBinding.mp4
自動生成物件綁定代碼 (Hotkey: Shift+B) - 手動 (Manual)
OxGFrame_AutoBinding.mp4
影音模塊 (連動 AssetLoader 實現自動卸載),支援多平台加載方式 (Local, StreamingAssets, URL),並針對 WebGL 進行細節校正。
- AudioFrame : Audio (2D/3D) 播放,採用 Unity Mixer 進行音軌控制 (需透過 Samples Import AudioManager Prefab)。
- VideoFrame : Video 播放,支援 RenderTexture 與 Camera 渲染模式。
遊戲階段整合模塊 (FSM 概念),將 Startup、Logo、Hotfix、Patch、Login、Lobby、Fight 等遊戲階段統一整合與切換 (階段規劃依專案自行劃分實作)。
網路模塊,以 NetManager 管理多網路節點 (NetNode),支援心跳檢測、超時處理、重新連接回調與 INetTips 網路狀態介面,可自行擴展 Provider,目前提供:
- TCP (Telepathy),已處理分黏包 (Packet 前 4 bytes 表示封包長度)
- KCP (kcp2k)
- WebSocket (UnityWebSocket)
示例使用 ioGame 作為服務端:
| ioGame Server (TCP) | NetFrame - TcpNetProvider Client |
|---|---|
![]() |
![]() |
![]() |
![]() |
| ioGame Server (WebSocket) | NetFrame - WebSocketNetProvider Client |
|---|---|
![]() |
![]() |
事件委派中心,自定義管理類繼承 CenterBase<TCenter, TClass> 實現簡易事件派送,預設提供:
- EventCenter : 集中式 Event 整合模塊,自定義每個 Event 格式進行派送。
- APICenter : 集中式 Http API 整合模塊,使用 Acax 請求 (Http.Acax、HttpNativeClient.Acax、HttpNativeWebRequest.Acax)。
框架共用模塊,承載框架層級的編輯器工具,所有模組皆依賴此模塊 (單獨安裝任一模組也會自動帶入)。
- API Updater : 框架 API 對齊校驗工具 (選單 OxGFrame/Others/API Updater),升級框架版本後掃描專案中的過時 API,型別感知比對且多載歧義自動決議,逐項預覽確認後才套用更新。
OxGFrame_FlppyBird.mp4
- Coding Style wiki (代碼風格)
- Macro Defitions wiki (宏定義)
- Encryption and Decryption Efficiency wiki (加解密效率)
- Roadmap wiki
This library is under the MIT License.


























