虚幻引擎5文档已被迁移至 Epic开发者社区

本页将介绍首次设置和运行nDisplay的方法。

步骤1 - 设置nDisplay的项目

设置项目以使用nDisplay的最简单方法是用 nDisplay 模板项目进行创建。你可以在 新建项目 窗口的 电影、电视与实况活动 分类中找到此模板：

此模板将自动启用nDisplay插件，配置一些实用的额外设置，包括一些示例配置文件。

步骤2 - 设置配置文件

需告知nDisplay以下信息：要在网络中使用的不同计算机、要渲染到此类计算机的屏幕或投影仪大小和分辨率、此类屏幕在3D空间中的空间关系等。为此，需创建配置文件，以在一系列设置中说明此类信息。

通常设置好配置文件后，只需在网络拓扑发生变化时修改：例如，需更改渲染到的计算机或更改真实世界屏幕和显示器的物理布局时。

将配置文件保存在项目的内容文件夹中。下一步将对其进行使用。

步骤3 - 打包和部署

每次更改项目中的内容时，都需打包游戏并将其部署到配置文件中已辨识的所有计算机上。

1. 在虚幻编辑器中，打包Windows的游戏。详情请参阅 编译操作：烘焙、打包、部署和运行 。

   请确保将游戏打包到不含空格的路径。

2. 在虚幻引擎安装文件夹下找到 Engine\Binaries\DotNET\nDisplayListener.exe 应用程序。将该应用程序复制到内含游戏的已打包 .exe 文件的文件夹。

3. 将包含项目的已打包 .exe 文件和 nDisplay监听器 应用程序的文件夹复制到各计算机，此类计算机被辨识为配置文件中的群集节点。
   须将该文件夹放到所有计算机上完全相同的路径中。

4. 在各计算机上启动 nDisplayListener.exe 文件。

现在已将nDisplay所需全部内容部署到群集中的所有计算机上：应用程序的打包版本、定义nDisplay群集设置的配置文件，及正在运行的 nDisplay监听器 （其正等待来自 nDisplay启动器 的传入指令）。在下节中，将使用 nDisplay启动器 来指示各监听器，在自身群集节点上启动项目。

步骤4 - 启动所有群集节点

将项目成功部署到已在配置文件中辨识的所有计算机后，可使用 nDisplayLauncher 应用程序在所有计算机上同时启动该项目。

1. 如尚未运行 nDisplayLauncher 应用程序，请先进行启动。
   

   
   点击查看大图。

2. 添加打包的项目 .exe 文件到应用程序列表。
   点击 应用程序（Applications） 列表下的 添加（Add） ，然后浏览并选择打包的项目 .exe 文件。nDisplay启动器将把新应用程序添加到列表。点击名称以选择。

3. 指定配置文件。
   点击 配置文件（Config Files） 控件右侧的 添加（Add） ，然后浏览并选择配置文件。

   配置文件的路径和文件名都不能包含任何空格。

4. 点击 运行（Run） 。

nDisplay启动器 会向配置文件中各群集节点上的 nDisplay监听器 发送消息，指示其启动已打包项目。可看到各 nDisplay Listener 在其状态窗口中显示命令：

然后，各主机上的nDisplay监听器应启动虚幻引擎应用程序，其将开始渲染其主窗口的单个或多个已配置视口。

完成后点击 终止（Kill） 自动关闭所有计算机上虚幻引擎的所有实例，或直接关闭主计算机（primary computer）上运行的虚幻引擎实例。