在 Hugging Face Spaces 上託管 Unity 遊戲

Unity 遊戲的部署工作流程

Space 設定與本機設定

要開始，使用者必須在 Hugging Face 上建立一個新的 Space，並選擇 Static HTML 模板。Space 建立完成後，應使用 Git 將其克隆至本機：

git clone https://huggingface.co/spaces/{your-username}/{your-space-name}

Unity 建置設定

為了讓 Unity 專案相容於 Hugging Face Spaces，需要在 Unity 編輯器內進行以下設定變更：

  • Build Target（建置目標）: 前往 File > Build Settings，將目標平台切換為 WebGL。
  • Compression Format（壓縮格式）: 在 Player Settings 面板的 Publishing Settings 區段中，將 Compression Format 設為 Disabled。

可選的視覺自訂

Hugging Face 提供了專用的 Unity WebGL template 以提升遊戲在 Space 中的外觀。使用方式為將該儲存庫加入專案檔案，並在 Player Settings > Resolution and Presentation 中選取該模板。

上傳建置檔案

當專案以 WebGL 建置完成後，必須將建置資料夾中的產出檔案複製到已克隆的 Space 儲存庫中。由於 Unity 建置檔案可能相當龐大，需啟用 Git Large File Storage (LFS) 以追蹤建置目錄：

git lfs install
git lfs track Build/*

最後，使用標準的 Git 指令（git add、git commit、git push）將變更推送至 Hugging Face 儲存庫。

在 Spaces 中的 Unity 遊戲範例

以下幾個專案展示了此託管方式的可行性，包括：

  • Huggy：在 Spaces 上託管的可遊玩示範。
  • Farming Game：基於 Unity 的模擬遊戲。
  • Unity API Demo：展示 Unity 在此環境中功能的技術示範。

Sources