本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Epic Unreal 引擎

Unreal Engine 是一種即時 3D 建立工具，適用於擬真視覺效果和沉浸式體驗。使用提交者、Conda 套件和轉接器的 Deadline Cloud 支援 Unreal Engine，以提高渲染效能。本指南提供step-by-step說明，透過跨多部機器分配轉譯任務，更快速地轉譯您的 Movie Render 佇列專案。

支援概觀

下列元件支援 Unreal Engine：

Unreal Engine 版本相容性

下表顯示 Unreal Engine 版本的目前支援層級：

截止日期雲端 Conda 頻道

下表列出適用於 Unreal Engine 的所有 deadline-cloud conda 套件，可供 Conda 頻道中的服務受管機群使用：

開始使用

先決條件

在安裝 Unreal Engine 提交者之前，請確定您有下列項目：

安裝提交者

Unreal Engine 提交者將 Deadline Cloud 功能新增為 Unreal Engine 的外掛程式，可讓您將 Movie Render 佇列任務直接提交至 Deadline Cloud 進行轉譯。

選擇您的分支

為您的部署選取適當的分支：

建立新的 Windows Amazon EC2 執行個體以在 上安裝 Unreal （選用）

如果您要在全新的 Windows Amazon Elastic Compute Cloud (Amazon EC2) 執行個體上設定 做為提交者，則具有 200 GB 儲存空間的 g5.2xlarge 執行個體是合理的下限：

Windows 長路徑

下列許多步驟可能會建立超過預設 Windows 路徑長度上限的檔案。在 Windows 機器上建置和安裝 Deadline Cloud for Unreal Engine 提交者或轉接器之前，我們建議您啟用 Windows 長路徑支援。若要這樣做，請遵循最大檔案路徑限制頁面上的指示，例如執行 PowerShell 命令。

工作者代理程式上也有未設定為支援 Windows 長路徑的相依性所造成的開啟問題。當您設定工作者時，請遵循連結問題中的解決方法步驟，以完全支援 Windows 長路徑，直到問題解決為止。

安裝建置工具

Unreal 提交者外掛程式目前必須在本機編譯。

安裝截止日期雲端監視器

Deadline Cloud Monitor 用於管理將任務提交至 Deadline Cloud 的登入資料，並監控任務的狀態。

環境設定

截止日期 雲端軟體安裝

deadline-cloud-for-unreal-engine 從發行分支或主線複製或下載，取決於您想要的是最新測試的發行版本或所有最近的遞交。

git clone https://github.com/aws-deadline/deadline-cloud-for-unreal-engine.git
cd deadline-cloud-for-unreal-engine
git switch release

選用 - 使用指令碼建置和安裝外掛程式

中的協助程式指令碼可scripts/build_plugin.py選擇性地自動執行接下來的兩個步驟。它會嘗試尋找最新版本的 Unreal、建置您的外掛程式和 Python 相依性，並將它們安裝在正確的位置。您可以覆寫設定，例如 Unreal 版本。若要查看完整的說明清單，請執行：

python scripts/build_plugin.py -h

若要使用最新的 Unreal Engine 安裝，建置並安裝目前的 複本deadline-cloud-for-unreal-engine做為提交者，請執行：

python scripts/build_plugin.py --install

如果您已成功使用此指令碼安裝 ，您可以跳至 建立機群。

建置 外掛程式

根據安裝 Unreal 所在的位置和安裝 的位置，調整以下前兩個路徑deadline-cloud-for-unreal-engine。

從 Unreal Install Batchfiles 資料夾 ( package 參數可以是任何新目錄，但您希望UnrealDeadlineCloudService稍後呼叫它）：

cd C:\Program Files\Epic Games\UE_5.5\Engine\Build\BatchFiles
runuat.bat BuildPlugin -plugin="C:\deadline\deadline-cloud-for-unreal-engine\src\unreal_plugin\UnrealDeadlineCloudService.uplugin" -package="C:\UnrealDeadlineCloudService"

將上方的「套件」資料夾複製到 Unreal 安裝的外掛程式資料夾 （例如，C:\Program Files\Epic Games\UE_5.5\Engine\Plugins\UnrealDeadlineCloudService)。

Python 相依性

有 4 種方式可以安裝所需的 Python 相依性。

1. 如果您已從上述版本分支建置並安裝外掛程式，您可以從 pip 安裝 。使用以下安裝命令，調整 Unreal 安裝的路徑：

"C:\Program Files\Epic Games\UE_5.5\Engine\Binaries\ThirdParty\Python3\Win64\python" -m pip install deadline-cloud-for-unreal-engine --target "C:\Program Files\Epic Games\UE_5.5\Engine\Plugins\UnrealDeadlineCloudService\Content\Python\libraries"

2. 或者，在您的 .uplugin 檔案中 （在上述步驟中，這將存在於 C:\Program Files\Epic Games\UE_5.5\Engine\Plugins\UnrealDeadlineCloudService\UnrealDeadlineCloudService.uplugin)，您可以新增符合 GitHub/PyPI deadline-cloud-for-unreal-engine中最新版本 的PythonRequirements區段，例如：

"PythonRequirements":
[
    {
        "Platform": "All",
        "Requirements":
        [
            "deadline-cloud-for-unreal-engine>=0.5.0"
        ]
    }
]

您可能想要在 Unreal 的 Python 設定中停用「嚴格雜湊」功能，或為想要使用的特定程式庫和相依版本新增雜湊設定。

3. 如果您要從主線提取，您可能有尚未發佈至 PyPI 的 Python 相依性 - 您將需要建置和安裝本機複本，這些複本可以使用雜湊完成。需要變更.whl檔案，以反映由雜湊組建輸出的版本：

pip install hatch
hatch build
"C:\Program Files\Epic Games\UE_5.5\Engine\Binaries\ThirdParty\Python3\Win64\python" -m pip install dist\deadline_cloud_for_unreal_engine-0.2.2.post21-py3-none-any.whl --target "C:\Program Files\Epic Games\UE_5.5\Engine\Plugins\UnrealDeadlineCloudService\Content\Python\libraries"

4. 最後，提交者安裝程式可以安裝 Python 相依性。這些可能已過時，且您的上述程式碼來自發行版本或主要分支，目前不應偏好此方法。

更新通知

Unreal Editor 啟動時，提交者外掛程式會自動檢查 GitHub 上是否有較新的版本。如果有可用的更新，對話方塊會提示您造訪發行頁面。

若要停用更新通知，請在截止日期雲端設定面板 (編輯 > 專案設定 > 外掛程式 > 截止日期雲端) 的一般設定下取消核取顯示提交者更新通知。

或者，您可以使用 CLI：

deadline config set settings.submitter_update_notification false

若要重新啟用：

deadline config set settings.submitter_update_notification true

建立機群

如果您已經有 Windows 機群，而且不需要設定新的機群，您可以跳到 提交測試轉譯。

建立服務受管機群 (SMF)

如果您還沒有 SMF，請遵循服務受管機群使用者指南來建立 SMF。在服務受管機群 (SMFs) 上，Unreal Engine 和轉接器會使用具有預設佇列環境的 deadline-cloud conda 通道自動提供。您已準備好開始轉譯。繼續提交測試轉譯以下操作以提交測試轉譯任務。

建立客戶受管機群 (CMF)

提交測試轉譯

此範例使用 Unreal Marketplace 中的 Meerkat 示範：

設定客戶受管機群 (CMF) 工作者

本節將逐步引導您設定 Amazon EC2 執行個體做為 Deadline Cloud with Unreal Engine 的 CMF 工作者。

概觀

以下是 CMF 和 SMF 之間的主要差異：

選擇您的分支

為您的部署選取適當的分支：

Amazon EC2 執行個體設定

以下是建議的執行個體組態：

軟體安裝

1。安裝 Unreal Engine：

2. 安裝 NVIDIA GRID 驅動程式：

安裝建置工具

Unreal 外掛程式目前必須在本機編譯。

截止日期 雲端軟體安裝

deadline-cloud-for-unreal-engine 從發行分支或主線複製或下載。確保您的程式庫工作者版本與提交者所使用的版本相容。

git clone https://github.com/aws-deadline/deadline-cloud-for-unreal-engine.git
cd deadline-cloud-for-unreal-engine
git switch release

選用 - 使用指令碼建置和安裝外掛程式和相依性：

中存在一個協助程式指令碼scripts/build_plugin.py，可以自動化剩餘的安裝步驟。它會嘗試尋找最新版本的 Unreal、建置您的外掛程式和 python 相依性，並將它們安裝在正確的位置。例如要使用的 Unreal 版本之類的設定可以覆寫。若要查看完整的說明清單，請執行：

python scripts/build_plugin.py -h

若要使用最新的 Unreal Engine 安裝，以工作者deadline-cloud-for-unreal-engine身分建置和安裝目前的 複本，請執行：

python scripts/build_plugin.py --install --worker

透過執行下列動作來設定截止日期雲端工作者代理程式：

install-deadline-worker ^
  --farm-id FARM_ID ^
  --fleet-id FLEET_ID ^
  --region REGION ^
  --allow-shutdown

如果您已使用此指令碼安裝 並成功設定工作者代理程式，您可以跳至 啟動截止日期雲端工作者代理程式服務。

python -m pip install deadline-cloud-worker-agent

必須安裝正確的轉接器版本，視使用的提交者版本而定。如果您使用 GitHub 中發行分支的提交者版本，您可以直接使用 pip 安裝 ：

python -m pip install deadline-cloud-for-unreal-engine

如果您使用的是主線或自訂的開發中版本提交者，為了避免相容性問題，我們建議您從相同版本的程式碼建置和安裝，或從提交者建置的 .whl 檔案傳輸：

pip install hatch
hatch build
python -m pip install dist\my-built-wheel.whl

建置外掛程式

根據安裝 Unreal 所在的位置和安裝 的位置，調整以下前兩個路徑deadline-cloud-for-unreal-engine。

從 Unreal Install Batchfiles 資料夾 ( package 參數可以是任何新目錄，但您希望UnrealDeadlineCloudService稍後呼叫它）：

cd C:\Program Files\Epic Games\UE_5.5\Engine\Build\BatchFiles
runuat.bat BuildPlugin -plugin="C:\deadline\deadline-cloud-for-unreal-engine\src\unreal_plugin\UnrealDeadlineCloudService.uplugin" -package="C:\UnrealDeadlineCloudService"

將上方的「套件」資料夾複製到 Unreal 安裝的外掛程式資料夾 （例如，C:\Program Files\Epic Games\UE_5.5\Engine\Plugins\UnrealDeadlineCloudService)。

pywin32

Unreal 的 Python 版本將需要 pywin32。使用 Unreal 的第三方 Python 安裝複本進行 Pip 安裝：

"C:\Program Files\Epic Games\UE_5.5\Engine\Binaries\ThirdParty\Python3\Win64\python" -m pip install pywin32

啟動截止日期雲端工作者代理程式服務

在您的 CMF 工作者執行個體上：

Perforce 登入資料管理

本節涵蓋將 Perforce 與截止日期雲端工作者整合的安全登入資料管理。

概觀

有數種方法可以為截止日期雲端工作者設定 Perforce 登入資料。每個方法都有不同的安全性影響和使用案例：

P4 登入資料基本概念

若要擷取連線設定，包括 Perforce 伺服器 URL 和連接埠、使用者名稱和密碼，Perforce 遵循下列優先順序：

使用這些優先順序時，如果您有下列設定：

產生的 Perforce 連線將是：

Port = ssl:perforce.from.env:1666
User = user.from.registry
Password = password.from.connection

Secrets Manager （建議）

Secrets Manager 為 CMF 和 SMF 部署提供最安全且可擴展的解決方案。

此方法提供下列優勢：

步驟 1：在 Secrets Manager 中建立秘密

建立包含 Perforce 連線參數的秘密。

必要的鍵/值對：

範例秘密：

{
   "P4PORT": "ssl:your-perforce-server.com:1666",
   "P4USER": "your-perforce-username",
   "P4PASSWD": "your-perforce-password"
}

若要建立秘密：

步驟 2：授予工作者存取秘密的權限

工作者需要存取秘密的secretsmanager:GetSecretValue許可。這遵循與管理 Windows 任務使用者秘密相同的模式。

若要授予存取權：

任務環境變數

您可以在工作區建立發生的任務環境中傳遞連線憑證，例如在 p4_sync_smf_environment、ugs_sync_smf_environment 或 CMF 的類似環境中。或者，建立新的環境範本，並在任務前面加上它。

name: P4Credentials
variables:
  P4PORT: ssl:my-perforce.com:1666
  P4USER: j.doe
  P4PASSWD: MyVeRyS3cretP4ssW0rd

此方法具有下列安全風險：

佇列環境變數

根據截止日期雲端使用者指南，您可以使用佇列環境為佇列中的任務提供軟體應用程式、環境變數和其他資源。佇列環境範例可在 deadline-cloud-samples 的 queue_environments 資料夾中找到。

使用截止日期雲端監視器或主控台新增佇列環境

使用 CLI 新增佇列環境

Windows 登錄檔 （僅限 CMF)

Windows 登錄檔會在工作者電腦上提供本機登入資料儲存。此方法使用標準 Perforce 優先順序系統，其中存放登入資料：

此方法僅適用於您可以直接存取以設定工作者機器的 CMF 部署。

預先設定的管理員使用者 （僅限 CMF)

建立專用 P4 使用者來轉譯具有非過期連線的節點，以消除傳遞秘密資料的需求，例如使用者名稱和密碼。在此情況下，單一專用 P4 使用者可用來連線至所有 P4 伺服器，包括可存取專案儲存庫的 Commit （主要） 和 Edge 伺服器。

因此，只有在工作者上未設定預設值時，您只需要傳遞要連線的連接埠。這可以透過在類似上述步驟的工作環境或佇列環境中新增下列項目來實現：

name: P4Sync
variables:
  P4PORT: ssl:my-perforce.com:1666

建立 Perforce 轉譯任務

本節將逐步引導您設定 Perforce 整合的轉譯任務資料資產，以便從 Unreal Engine 將 Perforce 整合的轉譯任務提交至 Deadline Cloud。

先決條件

在 Perforce 儲存庫中從 Unreal Engine 提交電影渲染佇列 (MRQ) 任務之前：

不真實的專案設定：

截止日期雲端設定：

Perforce 要求：

Perforce 轉譯任務架構

P4 轉譯任務使用 Perforce 同步功能擴展標準轉譯任務：

Deadline Cloud Perforce render job
├── Environments
│   ├── Apply Perforce Credentials from Secrets Manager
│   ├── Sync Perforce Environment (CMF/SMF)
│   │   └── Initializes Perforce workspace and syncs repository on workers
│   └── Launch UE Environment
│       └── Starts Unreal Engine with Perforce workspace paths
└── Steps
    └── Render Step
        └── Executes Movie Render Queue process

與標準任務的主要差異：

設定 Perforce 轉譯任務元件

請依照下列步驟建立 Perforce 整合轉譯任務所需的資料資產。

1. 建立套用 Perforce Credentials 資料資產

設定 OpenJD 環境以從 Secrets Manager 擷取 Perforce 登入資料，並將其套用至 Perforce 連線。

組態步驟：

2. 建立 Perforce 同步環境資料資產

設定 OpenJD 環境以建立 Perforce 工作區、從 Perforce 伺服器同步檔案，以及在轉譯後清理工作區。

組態步驟：

3. 建立 Perforce Launch UE 環境資料資產

設定 OpenJD 環境以啟動具有 Perforce 整合的 Unreal Engine。這會自動參考由同步環境建立的 Perforce 工作區。

組態步驟：

4. 建立 Perforce 轉譯步驟資料資產

設定執行轉譯程序的 OpenJD 轉譯步驟。

組態步驟：

5. 建立 Perforce 轉譯任務資料資產

設定可協調整個轉譯工作流程的 OpenJD 轉譯任務。

組態步驟：

最佳實務

提交前檢查清單

效能最佳化

區塊大小組態：

請考慮下列其他最佳化：

監控與除錯

疑難排解

常見問題與解決方案

偵錯步驟

自訂主機需求

本節說明如何建立和使用 Unreal Engine 中 Deadline Cloud 轉譯的自訂主機需求。

概觀

主機需求定義哪些機群有資格執行特定的轉譯步驟。它們存放在UDeadlineCloudHostRequirements資產中，然後由DeadlineCloudRenderStep資產參考。

步驟 1：建立主機需求資產

步驟 2：載入預設 YAML 範本

這會載入基本需求，例如 CPU、記憶體、GPU、作業系統和架構。

步驟 3：設定基本 （系統） 需求

如果最大值 = 0，則該要求沒有上限。

步驟 4：新增自訂金額需求

當需求為數字時 （例如，授權數量、並行限制） 使用。

步驟 5：新增自訂屬性需求

用於根據標籤和標籤篩選工作者。

步驟 6：MRQ 中的可見性 （選用）

每個要求項目都有一個眼睛圖示。

此設定有助於簡化藝術家的 UI，同時保留技術限制條件。

步驟 7：將需求連接至轉譯步驟

使用此步驟的所有 MRQ 提交現在會強制執行您的主機選取邏輯。

摘要

使用主機需求資產，您可以：

此設定可改善任務路由一致性，並確保轉譯發生在正確的硬體上。

進階組態。

服務受管機群與客戶受管機群

服務受管機群 (SMF)

在服務受管機群上，Unreal Engine 和轉接器會自動使用具有預設佇列環境的 deadline-cloud conda 頻道。此設定提供最簡單的體驗。

客戶受管機群 (CMF)

對於客戶管理的機群，必須在工作者主機上手動安裝 Unreal Engine 和轉接器。此設定提供更多控制，並支援其他功能，例如 Perforce 整合。如需詳細說明，請參閱 設定客戶受管機群 (CMF) 工作者。

Unreal Engine 轉譯功能

Unreal Engine 的轉譯系統提供以下項目的完整支援：

Unreal Engine 整合提交者會自動偵測和設定所有轉譯功能。轉接器會維護適當的相依性處理，並支援高效的多鏡頭轉譯，而無需重新啟動 Unreal Engine。

開放原始碼資源

提交者和轉接器是開放原始碼，可在 GitHub 上取得：