本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

史诗虚幻引擎

虚幻引擎是一款实时 3D 创作工具，可提供逼真的视觉效果和身临其境的体验。虚幻引擎由 Deadline Cloud 提供支持，包括提交者、conda 包和用于提高渲染性能的适配器。本指南提供了分步说明，说明如何使用带有虚幻引擎的 Deadline Cloud，通过在多台计算机上分配渲染任务来更快地渲染影片渲染队列项目。

Support 概述

虚幻引擎由以下组件支持：

虚幻引擎版本兼容性

下表显示了虚幻引擎版本的当前支持级别：

截止日期云 Conda 频道

下表列出了适用于虚幻引擎的所有conda软件包，可供 deadline-cloud conda Service-managed 频道中的舰队使用：

开始使用

先决条件

在安装虚幻引擎提交器之前，请确保具备以下条件：

安装提交者

虚幻引擎提交者将 Deadline Cloud 功能作为插件添加到虚幻引擎，允许你将影片渲染队列任务直接提交到 Deadline Cloud 进行渲染。

选择你的分行

为您的部署选择合适的分支：

创建用于安装虚幻引擎的新 Windows Amazon EC2 实例（可选）

如果您以提交者的身份在全新的Windows亚马逊弹性计算云 (Amazon EC2) 实例上进行设置，那么具有 200 GB 存储空间的 g5.2xlarge 实例是合理的最低值：

Windows 漫长的路径

以下许多步骤可能会创建超过默认的 Windows 最大路径长度的文件。在你在 Windows 计算机上构建和安装虚幻引擎提交者或适配器的 Deadline Cloud 之前，我们建议你启用 Windows 长路径支持。为此，请按照 “最大文件路径限制” 页面上的说明进行操作，例如运行PowerShell 命令。

工作器代理上还有一个未解决的问题，这是因为依赖项未配置为支持 Windows 长路径。设置工作器时，请按照链接问题中的解决方法步骤完全支持 Windows 长路径，直到问题得到解决。

安装构建工具

虚幻提交者插件目前必须在本地编译。

安装截止日期云监视器

Deadline Cloud 监控器既用于管理您向 Deadline Cloud 提交作业的凭据，又用于监控您的作业状态。

环境设置

截止日期 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可以选择使用中的帮助脚本自动执行接下来的两个步骤。它会尝试查找最新版本的虚幻引擎，构建你的插件和Python依赖关系，并将它们安装在正确的位置。你可以覆盖诸如虚幻版本之类的设置。要查看完整的帮助列表，请运行：

python scripts/build_plugin.py -h

要以提交者deadline-cloud-for-unreal-engine身份构建并安装你当前安装的虚幻引擎副本，请运行：

python scripts/build_plugin.py --install

如果您已成功安装此脚本，则可以跳至创建舰队。

编译插件

根据你安装的虚幻引擎的位置和安装位置，调整下面的前两条路径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"

将上面的 “package” 文件夹复制到虚幻安装的 Plugins 文件夹（例如C:\Program Files\Epic Games\UE_5.5\Engine\Plugins\UnrealDeadlineCloudService）。

Python 依赖项

有 4 种方法可以安装所需的 Python 依赖项。

1. 如果您已经从上面的发布分支中构建并安装了插件，则可以从 pip 进行安装。使用以下安装命令，调整虚幻引擎安装路径：

"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），你可以添加一个与最新版本相匹配deadline-cloud-for-unreal-engine的PythonRequirements部分 GitHub/PyPI，例如：

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

你可能希望在虚幻引擎的Python设置中停用 “严格哈希” 功能，或者为你想要使用的特定库和依赖版本添加哈希设置。

3. 如果你要从主线提取，你可能有尚未发布到 PyPI 的 Python 依赖项——你需要构建并安装本地副本，这可以用 hatch 完成。需要更改该.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 依赖项可以由提交者安装程序安装。这些可能与你上面发布的版本或主线分支中的代码已经过时了，目前不应该首选这种方法。

更新通知

GitHub 当虚幻编辑器启动时，提交者插件会自动检查是否有较新的版本。如果有更新可用，则会出现一个对话框，提示您访问发布页面。

要停用更新通知，请取消选中 Deadline Cloud 设置面板（编辑 > 项目设置 > 插件 > Deadline Cloud）中 “常规设置” 下的 “显示提交者更新通知”。

或者，你可以使用 CLI：

deadline config set settings.submitter_update_notification false

要重新启用：

deadline config set settings.submitter_update_notification true

创建舰队

如果你已经有一个 Windows 队列并且不需要设置新的队列，你可以直接跳到提交测试渲染。

创建服务托管队列 (SMF)

如果您还没有 SMF，请按照服务管理队列用户指南创建 SMF。在服务管理舰队 (SMF) 上，虚幻引擎和适配器可使用带有默认队列环境的 deadline-cloud conda 通道自动使用。你已经准备好开始渲染了。继续执行提交测试渲染以下操作，提交测试渲染作业。

创建客户管理的车队 (CMF)

提交测试渲染

此示例使用虚幻商城中的猫鼬演示：

设置客户管理车队 (CMF) 工作人员

本节将引导你使用虚幻引擎将 Amazon EC2 实例设置为 Deadline Cloud 的 CMF 工作程序。

概述

以下是 CMF 和 SMF 之间的主要区别：

选择你的分行

为您的部署选择合适的分支：

亚马逊 EC2 实例设置

以下是推荐的实例配置：

软件安装

1。安装虚幻引擎：

2。安装 NVIDIA 网格驱动程序：

安装构建工具

虚幻插件目前必须在本地编译。

截止日期 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，可以自动执行剩余的安装步骤。它会尝试查找最新版本的虚幻引擎，构建你的插件和python依赖关系，并将它们安装在正确的位置。可以覆盖诸如要使用的虚幻版本之类的设置。要查看完整的帮助列表，请运行：

python scripts/build_plugin.py -h

要以 worker 的deadline-cloud-for-unreal-engine身份构建并安装你当前安装的虚幻引擎副本，请运行：

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

运行以下命令配置 Deadline Cloud 工作器代理：

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

如果您已经安装了此脚本并成功配置了工作器代理，则可以跳至启动 Deadline Cloud 工作者代理服务。

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

构建插件

根据你安装的虚幻引擎的位置和安装位置，调整下面的前两条路径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"

将上面的 “package” 文件夹复制到虚幻安装的 Plugins 文件夹（例如C:\Program Files\Epic Games\UE_5.5\Engine\Plugins\UnrealDeadlineCloudService）。

pywin32

虚幻引擎版本的 Python 需要使用 pywin32。使用虚幻引擎的第三方 Python 安装副本安装 Pip：

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

启动 Deadline Cloud 工作者代理服务

在你的 CMF 工作器实例上：

执行凭证管理

本节介绍将 Perforce 与 Deadline Cloud 工作人员集成的安全凭据管理。

概述

有几种方法可以为 Deadline Cloud 工作人员配置 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

这种方法存在以下安全风险：

队列环境变量

根据 De adline Cloud 用户指南，您可以使用队列环境为队列中的作业提供软件应用程序、环境变量和其他资源。队列环境示例可以在截止日期云样本的 queue_environments 文件夹中找到。

使用 Deadline 云监控器或控制台添加队列环境

使用 CLI 添加队列环境

Windows 注册表（仅限 CMF）

Windows 注册表在工作计算机上提供本地凭据存储。此方法使用标准 Perforce 优先级系统，其中凭据存储在：

此方法仅适用于您可以直接访问配置工作器计算机的 CMF 部署。

Pre-configured 管理员用户（仅限 CMF）

为具有未到期连接的渲染节点创建专用 P4 用户，无需传递用户名和密码等机密数据。在这种情况下，可以使用单个专用 P4 用户连接到所有 P4 服务器，包括可访问项目仓库的提交（主服务器）和边缘服务器。

因此，如果未在 workers 上配置默认端口，则只需传递要连接的端口。这可以通过在作业环境或队列环境中添加以下内容来实现，类似于上面记录的步骤：

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

创建 Perforce 渲染作业

本节将引导你配置 Perforce-integrated 渲染作业数据资产，这样你就可以从虚幻引擎向 Deadline Cloud 提交 Perforce-integrated 渲染作业。

先决条件

在 Perforce 存储库中使用虚幻引擎提交影片渲染队列 (MRQ) 作业之前：

虚幻项目设置：

截止日期云设置：

性能要求：

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-integrated 渲染作业所需的数据资产。

1. 创建应用性能凭证数据资产

设置 OpenJD 环境，用于从 Secrets Manager 检索 Perforce 凭证并将其应用于 Perforce 连接。

配置步骤：

2. 创建 Perforce 同步环境数据资产

设置 OpenJD 环境，用于创建 Perforce 工作区、同步来自 Perforce 服务器的文件以及在渲染后清理工作区。

配置步骤：

3. 创建 Perforce 启动 UE 环境数据资产

为启动集成了 Perforce 的虚幻引擎设置一个 OpenJD 环境。这将自动引用同步环境创建的 Perforce 工作区。

配置步骤：

4. 创建 Perforce 渲染步骤数据资源

设置 OpenJD 渲染步骤以执行渲染过程。

配置步骤：

5. 创建 Perforce 渲染作业数据资产

设置 OpenJD 渲染作业，以协调整个渲染工作流程。

配置步骤：

最佳实践

Pre-submission 清单

性能优化

区块大小配置：

考虑以下其他优化：

监控和调试

问题排查

常见问题和解决方案

调试步骤

自定义主机要求

本节介绍如何在虚幻引擎中为Deadline Cloud渲染创建和使用自定义主机要求。

概述

主机要求定义了哪些队列有资格运行特定的渲染步骤。它们存储在UDeadlineCloudHostRequirements资源中，然后由DeadlineCloudRenderStep资源引用。

步骤 1：创建主机需求资产

第 2 步：加载默认 YAML 模板

这将加载基本要求，例如 CPU、内存、GPU、操作系统和架构。

步骤 3：配置基本（系统）要求

如果 Max = 0，则该要求没有上限。

第 4 步：添加自定义金额要求

当要求为数字（例如，许可证数量、并发限制）时使用。

步骤 5：添加自定义属性要求

用于根据标签和标签筛选工作人员。

步骤 6：在 MRQ 中的可见性（可选）

每个要求条目都有一个眼睛图标。

此设置可用于简化美术师的用户界面，同时保留技术限制。

步骤 7：将要求附加到渲染步骤

现在，使用此步骤提交的所有 MRQ 都会强制执行您的主机选择逻辑。

Summary

使用主机需求资产，您可以：

此设置提高了作业路由的一致性，并确保在正确的硬件上进行渲染。

高级配置

Service-managed 舰队与客户管理的车队

Service-managed 舰队 (SMF)

在服务管理的舰队中，虚幻引擎和适配器可使用带有默认队列环境的 deadline-cloud conda频道自动使用。此设置提供了最简单的体验。

Customer-managed 舰队 (CMF)

对于客户管理的舰队，必须手动在工作主机上安装虚幻引擎和适配器。此设置提供了更多的控制并支持 Perforce 集成等其他功能。有关详细说明，请参阅设置客户管理车队 (CMF) 工作人员。

虚幻引擎渲染功能

虚幻引擎的渲染系统为以下内容提供全面支持：

所有渲染功能均由虚幻引擎集成提交者自动检测和配置。该适配器可以保持适当的依赖关系处理，并且无需重启虚幻引擎即可支持高效的多镜头渲染。

开源资源

提交者和适配器是开源的，可在以下网址获得： GitHub