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

Epic 虚幻引擎

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

支持概述

以下组件支持虚幻引擎：

虚幻引擎版本兼容性

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

截止日期云康达频道

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

开始使用

先决条件

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

安装提交者

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

选择你的分支机构

为您的部署选择相应的分支：

创建一个新的 Windows Amazon EC2 实例来安装虚幻引擎（可选）

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

Windows 漫长的路径

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

工作器代理上还存在一个未解决的问题，该依赖项在出厂时未配置为支持 Windows 长路径。在设置工作人员时，请按照链接问题中的变通步骤完全支持 Windows 长路径，直到问题得到解决。

安装编译工具

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

安装截止日期云监视器

截止日期云监控器既用于管理向截止日期云提交任务的凭据，又用于监控任务的状态。

环境设置

截止日期云软件安装

克隆或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"

将上面的 “包” 文件夹复制到虚幻装置的插件文件夹（例如，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文件以反映 hatch build 输出的版本：

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 设置面板（编辑 > 项目设置 > 插件 > 截止日期云）的 “常规设置” 下取消选中 “显示提交者更新通知”。

或者，你可以使用 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频道自动使用。https://docs.aws.amazon.com/deadline-cloud/latest/userguide/create-queue-environment.html#conda-queue-environment你已经准备好开始渲染了。继续执行提交测试渲染以下操作以提交测试渲染作业。

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

提交测试渲染

这个例子使用了来自虚幻商城的 Meerkat 演示：

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

本节将引导你使用虚幻引擎将亚马逊EC2实例设置为截止日期云的CMF工作线程。

概述

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

选择你的分支机构

为您的部署选择相应的分支：

亚马逊 EC2 实例设置

以下是推荐的实例配置：

软件安装

1。安装虚幻引擎：

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

安装编译工具

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

截止日期云软件安装

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 --worker

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

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

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

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"

将上面的 “包” 文件夹复制到虚幻装置的插件文件夹（例如，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 Worker 代理服务

在您的 CMF 工作器实例上：

Perforce 凭证管理

本节介绍用于将 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

密钥管理器（推荐）

密钥管理器为 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 的类似环境中。https://github.com/aws-deadline/deadline-cloud-for-unreal-engine/blob/mainline/src/unreal_plugin/Content/Python/openjd_templates/ugs/ugs_sync_smf_environment.yml或者，创建一个新的环境模板并将其添加到您的任务中。

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

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

队列环境变量

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

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

使用 CLI 添加队列环境

Windows 注册表（仅限 CMF）

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

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

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

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

因此，如果未在工作人员上配置默认端口，则只需要传递要连接的端口。您可以通过在作业环境或队列环境中添加以下内容来传递端口，与上述步骤类似：

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集成使同步时间与更改内容成正比，而不是与项目大小成正比：

要在服务管理的队列上重复使用客户工作空间，请启用永久存储，以便将保存同步工作空间的卷重新分配给未来的工作人员。

如果您的队列区域和Perforce服务器之间的网络路径吞吐量低或延迟高，则该舰队所在区域的Perforce边缘服务器可以充当仓库数据的区域缓存。有关更多信息，请参阅《截止日期云开发者指南》中的 Perforce 源代码控制。

设置 Perforce 渲染作业组件

按照以下步骤为 Perforce-integrated 渲染作业创建所需的数据资产。

1. 创建 Apply Perforce 证书数据资产

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

配置步骤：

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

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

配置步骤：

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

设置一个 OpenJD 环境，用于启动集成了 Perforce 的虚幻引擎。这会自动引用同步环境创建的 Perforce 工作空间。

配置步骤：

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

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

配置步骤：

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

设置一个协调整个渲染工作流程的 OpenJD 渲染作业。

配置步骤：

将渲染输出提交回 Perforce

默认情况下，Perforce渲染作业仅通过作业附件上传输出。SubmitMode任务参数选择Perforce改为将渲染输出推送到中，因此完成的帧会与项目一起放置在仓库中。

只有自上次同步以来发生更改的文件才会出现在变更列表中。每项任务都会协调其生成的确切文件，集成会还原内容与仓库修订版本相同的文件，因此重新渲染未更改的帧不会生成更改列表条目。

将您的工作人员配置为以Perforce同一Perforce用户身份验证任务中的所有任务，因为聚合步骤会按所有者查找任务架。中推荐的凭据设置（Secrets Manager 中的单一共享密钥）已经满足了该要求。Perforce 凭证管理

最佳实践

Pre-submission 清单

性能优化

下表显示了该ShotsPerTask设置如何影响性能：

考虑以下其他优化：

监控和调试

问题排查

常见问题和解决方案

调试步骤

自定义主机要求

本节介绍如何为虚幻引擎中的截止日期云渲染创建和使用自定义主机要求。

概述

主机要求定义了哪些队列有资格运行特定的渲染步骤。它们存储在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