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

Switchboard 是Python应用程序，用于控制多个远程设备，依赖伙伴应用程序SwitchboardListener来与这些远程设备通信。 SwitchboardListener 是虚幻引擎的C++应用程序，在每个设备上运行TCP套接字服务器来与Switchboard共享JSON消息。

Switchboard的功能包括：

• 在 多用户会话 中，在设备上远程启动虚幻引擎。

• 在多个设备上启动 nDisplay 。

• 使用嵌入的

  [镜头试拍录制器](AnimatingObjects/Sequencer/Workflow/TakeRecorder)
  功能按钮进行录制。

• 将所有设备同步到特定的变更列表，并根据源编译你的项目和虚幻引擎。

• 连接到以下设备并进行控制： KiPro 、 Live Link Face 、 Shogun 和 SoundDevices 。

• 添加你自己的设备插件，并扩展Switchboard和SwitchboardListener的自定义功能按钮。

此页面介绍了Switchboard中的部分可用功能。若是刚开始使用Switchboard，请按照 Switchboard快速入门 中的步骤进行操作。如需所有可用设置的具体细节，请参见 Switchboard设置参考 。

虚拟制片角色

你可以在 虚拟制片（Virtual Production） 插件中创建设备角色，并将其分配到Switchboard中的虚幻设备。根据设备的角色，你可以在虚幻引擎中运行自定义逻辑并使用它们过滤 舞台监控 中的事件。角色可以存储在项目的 Config\Tags 文件夹下的 .ini 文件中。

以下步骤展示如何添加角色：

1. 在 编辑器（Editor） 的主菜单中，选择 编辑（Edit） > 项目设置（Project Settings） 以打开 项目设置（Project Settings） 窗口。

2. 在 项目设置（Project Settings） 中，在 插件（Plugins） 部分中打开 虚拟制片（Virtual Production） 插件的设置。

3. 选择 角色（Roles） 参数旁边的 编辑...（Edit…） 以打开 Gameplay标签（Gameplay Tag） 下拉窗口。

4. 展开 添加新Gameplay标签（Add New Gameplay Tag） 并输入角色的名称。选择 添加新标签（Add New Tag） 将角色添加到 .ini 文件。

默认情况下，Switchboard将在文件 VPRoles.ini 中查找角色。在 Switchboard设置 中，你可以设置文件名并为每个设备分配一个或多个角色。在虚幻引擎启动时，角色将传递到虚幻引擎。如果角色不受支持，例如如果 .ini 文件在设备上过期，将在Switchboard中记录一个错误。

使用Switchboard录制镜头试拍

你可以使用Switchboard中内置的TakeRecorder功能，在连接的虚幻设备中录制镜头试拍。Switchboard使用 OSC 与虚幻实例通信，以进行录制。Switchboard插件包含默认的 OSC监听器 ，可以为你创建此连接。

在Switchboard中，如果设备的OSC连接成功，状态图标将变成绿色。

• 在Switchboard上面，你可以设置 序列（Sequence） 名称、 Slate 名称和 镜头试拍（Take） 编号。

• 名称将立即反映在连接了OSC的虚幻设备的 TakeRecorder 中。

• 按右侧的红色按钮可以启动和停止录制。

• 如果设备正在录制，其背景在Switchboard将设置为红色。

• 每次录制后， 镜头试拍（Take） 编号都会增大。

使用Switchboard启动nDisplay

你可以将Switchboard设置为与你的所有nDisplay设备通信。当你选择在Switchboard中添加nDisplay设备时，将会添加 nDisplay配置文件 的位置。Switchboard解析配置文件并将文件中指定的群集节点转换为Switchboard设备。如需详细了解如何在Switchboard中进一步配置nDisplay设备，请参见 Switchboard设置 。

除了添加nDisplay设备，与nDisplay群集状态有关的信息还会显示在nDisplay监视器（nDisplay Monitor）面板的Switchboard窗口的右侧。下表介绍了监视器中包含的信息。无论何时出现意外值，单元格的颜色都会变成黄色，以示警告。

同步和编译

你可以将源功能按钮连接到Switchboard，然后根据特定的变更列表在所有已连接的设备中同步和编译你的项目和引擎。你可以在每个连接的设备上查看变更列表的内容，以了解哪些项需要更新。

按照下面的步骤将你的源功能按钮信息添加到Switchboard：

1. 打开 Switchboard设置（Switchboard Settings） 。

2. 在Switchboard设置（Switchboard Settings）对话框中，选中 源功能按钮（Source Control） 旁边的框。

3. 在 源功能按钮（Source Control） 下的部分中：

   1. 将 P4项目路径（P4 Project Path） 设置为你项目的Perforce流。

   2. 如果要从源编译引擎，请将 P4引擎路径（P4 Engine Path） 设置为你引擎的Perforce流。如果仅计划同步和编译项目，则不需要设置此路径。

   3. 将 工作区名称（Workspace Name） 设置为你Perforce工作区的名称。

4. 在 项目设置（Project Settings） 下的部分中：

   1. 将 Uproject 设置为你的虚幻引擎项目的位置。

   2. 将 引擎目录（Engine Dir） 设置为引擎的二进制版本所在的目录。

   3. 如果要从源编译引擎，请选中 编译引擎（Build Engine） 复选框。如果你仅编译项目，请使其保持未选中。

如果添加了你的源功能按钮信息，引擎和项目变更列表显示在Switchboard的设备列表上方。这意味着只能为所有设备的当前变更列表指定一个位置。

各个设备还可以显示其所拥有的引擎和项目变更列表。如果设备的变更列表在Switchboard顶部的选中变更列表后面，它的文本颜色将变成红色。

版本控制功能按钮