EKsumic's Blog

let today = new Beginning();

Click the left button to use the catalog.

OR

如何將 Unity WebGL 專案部署到 IIS

Unity 構建時的注意事項

在 Unity WebGL 的構建過程中:

  1. 選擇壓縮格式
    • 推薦選擇 GzipBrotli
  2. 啟用 Decompression Fallback
    • 勾選 Decompression Fallback,確保瀏覽器在無法解壓壓縮文件時可以加載未壓縮版本。

IIS 配置

  1. 新增 MIME 類型

    • 打開 IIS 管理器,點選網站,點擊右側的「MIME 類型」。
    • 添加以下 MIME 類型:
      • 副檔名.unityweb
      • MIME 類型application/octet-stream
  2. 自動生成的 web.config 當使用 IIS 部署 WebGL 專案時,系統會自動生成 web.config 文件,無需手動編輯。如果需要進一步配置,可以參考以下內容:

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
        <staticContent>
            <mimeMap fileExtension=".unityweb" mimeType="application/octet-stream" />
        </staticContent>
    </system.webServer>
</configuration>

驗證部署

  1. 瀏覽器中訪問 index.html
  2. 確保所有文件加載正常,檢查瀏覽器開發者工具的 Network 標籤,確認 .unityweb 文件返回正確的狀態碼(200)。

總結

成功部署 Unity WebGL 到 IIS 的關鍵:

  • 確保正確的文件結構,完整上傳 BuildTemplateDataindex.html
  • 配置 IIS 的 MIME 類型,支持 .unityweb
  • 在 Unity 构建時啟用 Decompression Fallback

如此即可成功運行 WebGL 專案於 IIS 上!

This article was last edited at 2025-01-13 20:18:08

* *