鄧州網(wǎng)站制作seo1域名查詢
目錄
- Unity WebGL 編譯和打包說明
- WebGL 簡介
-
- WebGL 瀏覽器兼容性 (WebGL Browser Compatibility)
-
- 平臺支持 (Platform Support)
- 多線程支持
-
- 限制多線程支持的因素
- 安裝 Unity Hub 并添加所需模塊
- WebGL 開發(fā)
-
- WebGL Player 設(shè)置
-
- Resolution and Presentation
-
- Resolution
- WebGL Template
- Splash Image
- Other Settings
-
- Rendering
- Configuration
- Shader Variant Loading
- API Compatibility Level
- Script Compilation
- Optimization
- Stack Trace
- Legacy
- Publishing Settings
-
- Show Diagnostic Overlay 設(shè)置
- Important note about JS Memory
- 與瀏覽器腳本的交互
-
- 代碼示例：在 Unity 中調(diào)用 JavaScript 和 C/C++/C# 函數(shù)
-
- 在 Unity C# 示例中調(diào)用 JavaScript 代碼
- 在 Unity C# 腳本中調(diào)用 C/C++/C# 代碼示例
- 設(shè)置 JavaScript Plug-in
-
- 將你的 JavaScript 文件導(dǎo)入到 Unity 項目中
- 從 .jslib 文件類型中調(diào)用函數(shù)
- 使用 .jspre 文件類型包含 JavaScript 庫
- 從 Unity C# 腳本調(diào)用 JavaScript 函數(shù)
-
- 傳遞不同的變量從 JavaScript 到 Unity
-
- 數(shù)值類型
- 字符串
- 數(shù)組
- 紋理
- 在自己的作用域中執(zhí)行構(gòu)建代碼
-
- .jslib 插件中的代碼
- 從全局作用域（Global Scope）調(diào)用 JavaScript 函數(shù)
- 調(diào)用 JavaScript 函數(shù)的示例 Unity C# 代碼
- 使用 Unity 插件作為參考
- 從 JavaScript 調(diào)用 Unity C# 腳本函數(shù)
-
- 使用 SendMessage 輔助函數(shù)
- SendMessage 代碼示例
- 從 Unity C# 腳本調(diào)用 C/C++/C# 函數(shù)
-
- 將你的 C/C++/C# 插件導(dǎo)入 Unity 項目
- 在 Unity 中使用的 C++ 代碼示例
- 將靜態(tài)庫編譯為 Unity 插件
-
- 在 Unity 中使用靜態(tài)庫的步驟
-
- 下載 Emscripten SDK
- 配置現(xiàn)有項目腳本
- 更新編譯器選項
- 編譯并導(dǎo)入靜態(tài)庫文件
- 從 Unity C# 腳本調(diào)用靜態(tài)庫函數(shù)
- 在 Unity C#、JavaScript 和 C/C++/C# 代碼之間創(chuàng)建回調(diào)
-
- 使用 `makeDynCall` 函數(shù)進行回調(diào)
- 在腳本中使用回調(diào)
-
- JavaScript 插件代碼
- C++ 插件代碼
- Unity C# 代碼
- WebGL 原生插件與 Emscripten
-
- 目標版本
-
- 說明：
- 使用 Emscripten 編譯原生插件
-
- 注意：
- Emscripten 構(gòu)建標志
- Unity WebGL 中的內(nèi)存
-
- Unity WebGL 中的內(nèi)存約束
- Unity Heap
- 資源數(shù)據(jù)（Asset data）
- 垃圾回收
- WebGL 中的緩存行為
-
- 數(shù)據(jù)緩存
- 自定義 WebGL 緩存行為
- WebGL 圖形
-
- 相機清除（Camera clear）
- 延遲渲染
- 全局照明
- 線性渲染（Linear rendering）
- 視頻剪輯導(dǎo)入器（Video clip importer）
- WebGL 著色器代碼限制
- 字體渲染
- 抗鋸齒（Anti-aliasing）
- 反射探針（[Relection Probe](https://docs.unity3d.com/2022.3/Documentation/Manual/class-ReflectionProbe.html)）
- WebGL 2.0 支持
- WebGL 中的音頻
-
- 支持的類
- AudioSource
- AudioClip
- 壓縮音頻
- 音頻播放和瀏覽器安全
- WebGL 中的紋理壓縮
-
- 紋理壓縮格式
- 壓縮格式設(shè)置的優(yōu)先級
- 設(shè)置默認壓縮格式
- 通過腳本為桌面和移動瀏覽器創(chuàng)建構(gòu)建
- WebGL 中的嵌入式資源 (Embedded resources in WebGL)
-
- WebGL 中的嵌入式資源 (Embedded resources in WebGL)
- WebGL 中的輸入
-
- 游戲手柄和操縱桿支持
-
- 控制器映射
- 觸摸支持
- 鍵盤輸入和焦點處理
- 移動傳感器支持
- 光標鎖定支持
-
- 啟用光標鎖定
- 取消光標鎖定
- 粘性光標鎖定
- 全屏模式
- 在 Web 中啟用全屏模式
- 退出全屏模式
- 全屏模式和光標鎖定的附加注意事項
- 配置 WebGL 畫布大小
-
- 畫布大小元素
- 解耦渲染分辨率
-
- 覆蓋 DPI 縮放
- 手動更改 WebGL 畫布渲染大小
- WebGL 瀏覽器訪問設(shè)備功能
- WebGL Networking
-
- 在 WebGL 中使用 UnityWebRequest 類
-
- UnityWebRequest 下載
- 使用 Unity Multiplayer
- 從 JavaScript 使用 WebSockets 或 WebRTC
- WebGL 網(wǎng)絡(luò)的限制
-
- 不支持 native socket access
- WebGL 性能考慮
-
- 影響性能的 WebGL 特定設(shè)置
- WebGL 性能分析
- 后臺標簽中的 WebGL 內(nèi)容
- 節(jié)流 WebGL 性能
- 調(diào)試和排除 WebGL 構(gòu)建問題
-
- 瀏覽器中的 JavaScript 控制臺
- 開發(fā)構(gòu)建（Development builds）
- 異常支持
- 故障排除
- 構(gòu)建（Build）和分發(fā)（Distribute） WebGL 應(yīng)用程序
-
- WebGL 構(gòu)建設(shè)置
-
- 訪問 WebGL 的構(gòu)建設(shè)置
-
- WebGL 構(gòu)建設(shè)置參考
- 構(gòu)建 WebGL 應(yīng)用程序
-
- 構(gòu)建文件夾結(jié)構(gòu)
- 啟用異常
- 優(yōu)化你的 WebGL 構(gòu)建
-
- 優(yōu)化 WebGL 構(gòu)建的推薦圖形設(shè)置
-
- 設(shè)置推薦值及描述
- Lightmap Modes
- Fog Modes
- Instancing Variants
- Batch Renderer Group Variants
- Always Included Shaders
- 通過腳本編輯 Always Included Shaders 列表
- 推薦的 Player 設(shè)置以優(yōu)化 WebGL 構(gòu)建
-
- Player 設(shè)置快速參考
- API Compatibility Level
- IL2CPP Code Generation
- Managed Stripping Level
- Compression Format
- Data Caching
- Debug Symbols
- Enable Exceptions
- 推薦的質(zhì)量設(shè)置以優(yōu)化 WebGL 構(gòu)建
-
- 質(zhì)量級別
- 通過 C# 代碼更改質(zhì)量級別
- 使用 C# 代碼啟用優(yōu)化設(shè)置
-
- 創(chuàng)建一個 C# 腳本來優(yōu)化您的 WebGL 構(gòu)建
- 優(yōu)化 WebGL 平臺以適應(yīng)移動設(shè)備
-
- 優(yōu)化快速參考
- 優(yōu)化尺寸
-
- 使用 C# 啟用優(yōu)化尺寸設(shè)置
- 使用 Brotli 壓縮
-
- 使用 C# 更改壓縮格式
- 使用 Unity Addressables 系統(tǒng)
- 優(yōu)化音頻文件
- 優(yōu)化項目中的圖形
- 啟用 Shader 剝離
- 降低圖形質(zhì)量等級
- 使用 AssetBundles 減少加載時間
- WebGL 的發(fā)布大小和代碼剝離
-
- 針對 WebGL 的提示和技巧
- 代碼剝離
-
- 代碼剝離的問題
- 移動構(gòu)建輸出文件
- 增量構(gòu)建
- WebGL Template
-
- 添加 WebGL 模板
- 模板變量、宏和條件指令（Template variables, macros, and conditional directives）
-
- 內(nèi)部預(yù)處理變量（Internal preprocessor variables）
- JavaScript Macros
- 條件指令（Conditional directives）
-
- 自定義用戶變量（Custom user variables）
- index.html 文件的結(jié)構(gòu)
-
- 實例化函數(shù)：createUnityInstance()
- 構(gòu)建配置
- 構(gòu)建交互（Build interaction）
- 部署 WebGL 應(yīng)用程序
-
- 壓縮格式
- Web 服務(wù)器配置
- 解壓回退（Decompression fallback）
-
- 啟用解壓回退
- 禁用解壓回退
- Content-Encoding 頭
- WebAssembly streaming (higher level header)
- 其他頭
- 服務(wù)器配置代碼示例
-
- Nginx 服務(wù)器配置（WebGL 構(gòu)建）
- Apache 服務(wù)器配置（WebGL 構(gòu)建）
- IIS 服務(wù)器配置（壓縮的 WebGL 構(gòu)建，不帶解壓回退）
- IIS 服務(wù)器配置（未壓縮的 WebGL 構(gòu)建）
- 參考
Unity WebGL 編譯和打包說明
Unity 提供了對 WebGL 平臺開發(fā)游戲的支持。WebGL 允許開發(fā)者將實時交互的3D圖形發(fā)布到瀏覽器中。
WebGL 簡介
Unity 編輯器中的 WebGL 選項允許您將內(nèi)容發(fā)布為 JavaScript 程序，這些程序使用 HTML5/JavaScript、WebAssembly、WebGL rendering API 以及其他 Web 標準在 Web 瀏覽器中運行 Unity 內(nèi)容。
WebGL 瀏覽器兼容性 (WebGL Browser Compatibility)
Unity 對桌面瀏覽器的 WebGL 支持因瀏覽器而異，支持滿足以下條件的瀏覽器：
- 支持 WebGL 2：注意，Unity 不再為使用 Auto Graphics API 選項創(chuàng)建的構(gòu)建提供 WebGL 1 的支持。更多詳情，請參見 WebGL 1 的棄用。
- 符合 HTML 5 標準：瀏覽器應(yīng)符合 HTML 5 標準。
- 64 位并支持 WebAssembly：瀏覽器應(yīng)為 64 位并支持 WebAssembly。
Unity WebGL 不支持移動設(shè)備。盡管可能在高端設(shè)備上運行，但當前的移動設(shè)備通常性能不足且內(nèi)存不夠，無法支持 Unity WebGL 內(nèi)容。
Unity WebGL 支持一些壓縮紋理格式。有關(guān) Unity WebGL 支持的壓縮紋理格式的信息，請參見 Recommended, default, and supported texture compression formats, by platform 。
平臺支持 (Platform Support)
大多數(shù)流行的桌面瀏覽器版本都支持 Unity WebGL 內(nèi)容，但請注意，不同的瀏覽器提供的支持水平不同。例如，Unity WebGL 不支持移動設(shè)備。
由于平臺本身的限制，WebGL 構(gòu)建中的以下功能不可用或有限：
- Visual Studio 中缺乏 WebGL 構(gòu)建調(diào)試支持Visual Studio 不支持調(diào)試 Unity WebGL 構(gòu)建。更多信息，請參見 Debug and troubleshoot WebGL builds 。
- 缺乏 Unity 緩存和緩存腳本支持由于瀏覽器對文件系統(tǒng)的訪問受限，WebGL 構(gòu)建不支持 Unity Cache 和 Caching Scripting API。對資產(chǎn)數(shù)據(jù)（asset data）和 AssetBundles 的網(wǎng)絡(luò)請求會被緩存到瀏覽器緩存中。請參閱 Cache behavior in WebGL 。
- 缺乏線程支持由于 JavaScript 不支持線程，因此不支持線程。這適用于 Unity 內(nèi)部使用線程來加速性能的情況，以及在腳本代碼和 managed DLL 中使用線程的情況。本質(zhì)上，
System.Threading命名空間中的任何內(nèi)容都不支持。 - 網(wǎng)絡(luò)限制WebGL 平臺不支持以下幾項網(wǎng)絡(luò)功能：
- 出于安全考慮，瀏覽器不允許直接訪問 IP sockets 。更多信息，請參見 Web networking 。
System.Net命名空間中的 .NET networking class 不受支持。- 由于瀏覽器的安全限制，WebGL 平臺不支持 native socket 訪問。因此，WebGL 也不支持 ICMP ping 或
UnityEngine.Ping等功能。
- 圖形限制WebGL 平臺的圖形 API 基于 OpenGL ES 圖形庫的功能，有一些限制。更多信息，請參見 WebGL graphics 。
- 音頻限制WebGL 構(gòu)建使用基于 WebGL Audio API 的自定義音頻后端，但它只支持基本的音頻功能。更多信息，請參見 Audio in WebGL 。
- 代碼的動態(tài)生成WebGL 是一個 AOT（Ahead Of Time）平臺，因此不允許使用
System.Reflection.Emit動態(tài)生成代碼。所有其他 IL2CPP 平臺、iOS 和大多數(shù)游戲主機也是如此。 - 復(fù)制和粘貼復(fù)制和粘貼功能僅在 Unity UI 內(nèi)部有效。無法從系統(tǒng)剪貼板（system clipboard）復(fù)制和粘貼，也就是說，無法與外部應(yīng)用進行復(fù)制或粘貼操作。
多線程支持
盡管 Unity 為 native C/C++ 代碼提供了多線程支持，但由于 WebAssembly 的限制，Web 平臺尚不支持 C# 多線程。這意味著使用 Web 平臺構(gòu)建的應(yīng)用必須在單個 C# 線程上運行。
- Web 平臺僅在啟用 Web Player settings中的 Native C/C++ support 支持時支持 C/C++ 多線程。
- 當
document處于安全上下文中時，Web 平臺支持多線程。 - 服務(wù)器必須設(shè)置以下 HTTP 響應(yīng)頭：
- Cross-Origin-Opener-Policy: same-origin
- Cross-Origin-Embedder-Policy: require-corp
- Cross-Origin-Resource-Policy: cross-origin
- 在 Web 平臺上執(zhí)行復(fù)雜的異步任務(wù)的推薦方法是使用協(xié)程（不是多線程操作）。更多信息，請參見 coroutines 文檔。
限制多線程支持的因素
- 本地堆棧掃描（native stack scanning）的限制Web 平臺使用 WebAssembly，這是一種用于在 Web 瀏覽器中安全高效地執(zhí)行 Unity 代碼的字節(jié)碼格式。Web 瀏覽器設(shè)計為在安全和隔離的環(huán)境中運行代碼，阻止直接訪問本地 WebAssembly 堆棧。這影響了多線程垃圾回收，因為 Web 的垃圾回收器僅在每幀結(jié)束時運行一次，而不像其他平臺那樣在多幀之間增量運行。
- 沒有搶占式線程信號（pre-emptive thread signaling）支持Web 上的后臺工作線程獨立并行執(zhí)行代碼。在 native 平臺上，主線程可以同步發(fā)送信號給其他線程暫停以進行垃圾回收。Web 上不支持這種同步信號，這阻止了 WebAssembly 編譯的 C# 代碼在多個線程上運行。
- 其他資源 (Additional Resources)
- Secure context
- Garbage collection
安裝 Unity Hub 并添加所需模塊
要構(gòu)建 WebGL 應(yīng)用程序，首先必須安裝 Unity Hub，然后添加 WebGL Build Support 模塊。
有關(guān)如何完成這些步驟的信息，請參閱安裝 Unity Hub和向 Unity 編輯器添加模塊。
WebGL 開發(fā)
WebGL Player 設(shè)置
使用 Player 設(shè)置了解 Unity 如何構(gòu)建（build）并顯示最終的 WebGL 應(yīng)用程序。有關(guān)一般 Player 設(shè)置的說明，請參閱 Player settings。
要訪問 WebGL Player 設(shè)置：
- 從 Unity 主菜單中，轉(zhuǎn)到
Edit > Project Settings > Player。Player 設(shè)置窗口將出現(xiàn)。 - 選擇 WebGL 選項卡以查看 WebGL Player 設(shè)置。
注意：雖然 WebGL Player 設(shè)置中顯示了圖標面板，但沒有圖標設(shè)置可用，因為 WebGL 游戲不使用圖標。
有關(guān) WebGL Publishing Settings 的更多信息，請參閱 WebGL Building and Running。
Resolution and Presentation
使用 Resolution and Presentation 部分自定義屏幕外觀的各個方面。
Resolution
WebGL Template
選擇要用于 WebGL 項目的模板：
- Default 頁面是一個簡單的白色頁面，灰色畫布上有加載條。
- Minimal 頁面只有運行 WebGL 內(nèi)容所需的基本代碼。
- PWA 頁面包括一個 Web manifest 文件和 service worker 代碼。您可以指定自己的模板，以便在類似于成品游戲的環(huán)境中運行您的游戲。有關(guān)詳細說明，請參閱 Using WebGL Templates 。
Splash Image
使用虛擬現(xiàn)實啟動畫面設(shè)置為 XR 顯示器選擇自定義啟動圖像。有關(guān)常見啟動屏幕設(shè)置的信息，請參閱 Splash Screen 。
Other Settings
Rendering
使用這些設(shè)置可以自定義 Unity 如何為 WebGL 平臺渲染您的游戲。
Configuration
Shader Variant Loading
使用這些設(shè)置控制運行時著色器使用的內(nèi)存量。
API Compatibility Level
您可以為所有 target 選擇 Mono API 兼容性級別。有時，第三方 .NET 庫使用的功能超出了您的 .NET 兼容性級別。要了解這種情況下的情況以及如何最好地解決它，請嘗試以下建議：
- 為 Windows 安裝 ILSpy 。
- 將導(dǎo)致問題的 API 兼容性級別的 .NET 程序集拖入 ILSpy。您可以在
Frameworks/Mono/lib/mono/YOURSUBSET/下找到這些問題文件。 - 拖入您的第三方程序集。
- 右鍵單擊第三方程序集并選擇 Analyze 。
- 在分析報告中，檢查 Depends on 部分。報告會突出顯示第三方程序集依賴但不在您選擇的 .NET 兼容性級別中可用的任何內(nèi)容。
Script Compilation
Optimization
Stack Trace
為 WebGL 平臺選擇日志記錄設(shè)置。
選擇與每種日志類型（Error、Assert、Warning、Log 和 Exception）對應(yīng)的選項，以基于所需的日志記錄類型啟用首選的堆棧跟蹤方法。有關(guān)更多信息，請參閱 stack trace logging。
Legacy
啟用 Clamp BlendShapes（已棄用）選項以在 Skinned Mesh Renderers 中夾住混合形狀權(quán)重的范圍。
Publishing Settings
使用 Publishing Settings 配置 Unity 構(gòu)建 WebGL 應(yīng)用程序的方式。例如，您可以選擇啟用瀏覽器緩存以在構(gòu)建中存儲其文件。
Show Diagnostic Overlay 設(shè)置
為了幫助優(yōu)化 WebGL 構(gòu)建并診斷潛在問題，您可以通過啟用此設(shè)置查看診斷信息（目前限于內(nèi)存使用情況）。啟用后，構(gòu)建上會出現(xiàn)一個圖標，顯示有關(guān)構(gòu)建的有用數(shù)據(jù)。此選項適用于開發(fā)和發(fā)布構(gòu)建。
要查看診斷信息，請在 Player settings 窗口（File > Build Settings > Player Settings > Publishing Settings）中啟用 Show Diagnostics Overlay 選項。
在桌面上，診斷圖標出現(xiàn)在 WebGL 畫布的頁腳：
在移動設(shè)備上，診斷圖標出現(xiàn)在屏幕右下角：
點擊 Diagnostics 圖標。會出現(xiàn)一個覆蓋層，顯示 JavaScript 內(nèi)存的詳細信息，其中進一步細分顯示 WASM 堆內(nèi)存使用情況：
覆蓋屏幕上顯示以下診斷信息：
屬性 (Property)
功能 (Function)
Total JS Memory
JavaScript（JS）堆的當前大小，包括未分配給任何 JS 對象的未使用內(nèi)存，以兆字節(jié)（MB）為單位。
Used JS Memory
JS 對象使用的內(nèi)存，以兆字節(jié)（MB）為單位。
Total WASM heap memory
表示 C/C++ Unity 引擎使用 Emscripten 編譯的整個堆內(nèi)存的線性內(nèi)存，包括未分配的內(nèi)存，以兆字節(jié)（MB）為單位。
Used WASM heap
已分配的 WASM 堆空間，以兆字節(jié)（MB）為單位。
Important note about JS Memory
JS 內(nèi)存信息是使用 performance.memory API 獲得的，目前僅支持 Chrome 或 Edge。沒有其他 API 可返回此信息以供 Safari 或 Firefox 使用。
注意：iOS 設(shè)備不支持 performance.memory API。
在不支持此 API 的瀏覽器上，會顯示消息 “N/A”。
與瀏覽器腳本的交互
當你為 Web 構(gòu)建內(nèi)容時，可能需要與網(wǎng)頁上的其他元素進行通信，或者使用 Web API 來實現(xiàn) Unity 默認未提供的功能。
在這兩種情況下，你都需要直接與瀏覽器的 JavaScript 引擎進行交互。Unity Web 提供了不同的方法來處理這些交互。
代碼示例：在 Unity 中調(diào)用 JavaScript 和 C/C++/C# 函數(shù)
你可以使用代碼在插件和 Unity 代碼之間執(zhí)行交互。以下示例展示了如何在 Unity 項目中從 JavaScript 和 C/C++/C# 代碼調(diào)用各種類型的函數(shù)。
在 Unity C# 示例中調(diào)用 JavaScript 代碼
以下代碼是一個 JavaScript 示例，你的 Unity C# 腳本可以從中調(diào)用函數(shù)。
mergeInto(LibraryManager.library, {Hello: function () {window.alert("Hello, world!");},HelloString: function (str) {window.alert(UTF8ToString(str));},PrintFloatArray: function (array, size) {for(var i = 0; i < size; i++)console.log(HEAPF32[(array >> 2) + i]);},AddNumbers: function (x, y) {return x + y;},StringReturnValueFunction: function () {var returnStr = "bla";var bufferSize = lengthBytesUTF8(returnStr) + 1;var buffer = _malloc(bufferSize);stringToUTF8(returnStr, buffer, bufferSize);return buffer;},BindWebGLTexture: function (texture) {GLctx.bindTexture(GLctx.TEXTURE_2D, GL.textures[texture]);},});
以下代碼是一個 Unity C# 示例，調(diào)用了上述 JavaScript 示例中定義的函數(shù)。
using UnityEngine;
using System.Runtime.InteropServices;public class NewBehaviourScript : MonoBehaviour {[DllImport("__Internal")]private static extern void Hello();[DllImport("__Internal")]private static extern void Hel