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

如果您已遵循AJA媒体或 Blackmagic Design 硬件的快速入门指南进行了操作，那么您已经看到了一种设置媒体输入和媒体采集资源的可能方法，可以将SDI视频源导入和导出您的项目。

但是，您通常需要单个项目来处理多个不同的媒体配置。例如：

• 您可能需要在不同的计算机上处理这个项目，每个计算机都有不同的硬件或不同的连接设置。例如，一台计算机可能有AJA卡，而另一台计算机可能有Blackmagic卡；或者，连接到一台计算机上的端口1的视频源可以连接到另一台计算机上的端口2。

• 您可能需要能够在一台计算机上不同类型的源和输出之间切换项目。例如，您可能想要使用来自SDI连接的实时内容，但是当内容脱机时，则切换到使用磁盘上预先录制的文件作为输入。

• 您可能还需要更改虚幻引擎读取时间码和集中同步其帧率的方式，特别是当您更改到不同的源或输入时。例如，您可能想要仅在使用来自SDI连接的输入内容时锁定虚幻引擎的帧率。

在类似这些情况下，您不希望每次切换设置时都必须对媒体设置和项目内容进行深入更改。相反，您可以设置多个媒体配置文件，各个配置文件将与媒体输入、输出、时间码提供者和集中同步提供者相关的所有配置设置收集在一起。只需切换到不同的媒体配置文件，就可以立即更改整个媒体输入/输出设置。

媒体配置文件和代理的工作原理

媒体配置文件依赖于*代理*资源在两个不同的点之间建立连接：

• 一方面，是您在媒体配置文件中设置的输入和输出配置。

• 另一方面，是这些输入和输出在项目内容中使用或生成的位置。

下面的列表展示了上图中编号的部分：

1. 您在项目中设置了多个媒体配置文件：一个用于项目需要支持的各个使用场景。每个配置文件包含一个媒体源列表和一个媒体输出列表。您可以设置这些列表来确定您的项目将从何处获取视频输入，以及将采集发送到何处。
   例如，可以设置一个配置文件从AJA媒体卡获取输入，另一个配置文件从Blackmagic Design卡获取输入，第三个配置文件从磁盘上的文件获取输入。
   您还可以在单个媒体配置文件中进行混合和匹配。例如，单个媒体配置文件可以同时从文件和SDI内容中获得输入。

2. 当您安装了 媒体框架工具插件（Media Framework Utilities Plugin） 时，项目的 项目设置（Project Settings） 面板包含类似的输入和输出列表。媒体配置文件的输入列表中的每个编号条目都与项目设置的输入列表中的相同编号匹配，输出列表也是如此。
   您可以在项目设置中设置这些列表条目，以指向您在项目中创建的代理媒体源或代理媒体资源。

3. 然后，当需要在项目内容中设置媒体源或媒体输出时，您可以随时引用这些代理媒体资源。例如：

   1. 当您设置一个媒体束或媒体播放器时，您将它指向这些媒体代理资源之一，而不是指向直接表示文件、流或SDI输入的媒体源。

   2. 类似地，在设置媒体采集时，将输出发送到代理媒体输出，而不是直接发送到AJA或Blackmagic媒体输出。您可以在如上所示的虚幻编辑器中的 媒体采集（Media Capture） 面板中执行此操作，或者在运行时调用 创建媒体采集（Create Media Capture） 蓝图节点时执行此操作。如果您在项目设置中设置了输出列表，以包含对相同代理媒体输出的引用，那么采集将被转发到输出，并使用您在媒体配置文件中配置的匹配索引。

代理媒体源和代理媒体输出资源本身不包含任何重要的配置属性。它们只是作为一个通道，用于连接媒体配置文件中设置的输入和输出配置，以及由项目中其他资源实际使用或生成那些输入和输出的位置。

选择和保存活动媒体配置文件

每当您的项目在虚幻引擎或虚幻编辑器中加载时，它只能有一个活动的媒体配置文件（或者根本没有）。

当您在虚幻编辑器中打开项目时，您可以使用主关卡编辑器工具栏中的媒体配置文件菜单选择活动的媒体配置文件。

媒体配置文件是总是保存在虚幻引擎项目中的资源。但是，有关哪个媒体配置文件是活动中的选择将保存在各台计算机上，而不是保存在项目中。这意味着，一旦您在给定的计算机上为给定的项目设置了媒体配置文件，就再也不必更改它了（除非您的媒体硬件或配置发生更改）。

另一方面，当您运行项目的打包版本时，有关哪个媒体配置文件是活动中的选择总是由 启动媒体配置文件（Startup Media Profile） 设置决定，您可以在 插件（Plugins）> 媒体配置文件（Media Profile） 下的 项目设置（Project Settings） 窗口中找到该设置。

开始了解媒体配置文件和代理

在这个过程中，我们将设置两个媒体配置文件：一个播放来自本地电影文件的输入，另一个播放来自SDI卡的实时视频源。我们将设置两个独立的媒体束来播放关卡中的视频。最后，我们将使用代理媒体源将输入从媒体配置文件中配置的源重定向到媒体束。

1. 首先创建代理媒体源资源。在 内容浏览器（Content Browser） 中右键单击，从上下文菜单中选择 媒体（Media）> 代理媒体源（Proxy Media Source） 。
   
   将新资源命名为 VideoProxyInA 。

2. 重复前面的步骤创建另一个代理媒体源，但将其命名为 VideoProxyInB 。

3. 创建一个新的媒体束资源。在 内容浏览器（Content Browser） 中右键单击，选择 媒体（Media）> 媒体束（Media Bundle） 。
   
   将新资源命名为 MediaBundleA 。

4. 双击新的媒体束资源来编辑它。

5. 在 详细信息（Details） 面板中，找到 媒体源（Media Source） 设置，并从下拉列表中选择 代理媒体源（Proxy Media Source） 。
   

6. 展开 源（Source） 类别，并将 代理（Proxy） 设置为引用前面创建的 VideoProxyInA 资源。
   

7. 重复前面的步骤创建另一个媒体束。这次将它命名为 MediaBundleB ，并将其源代理设置为引用 VideoProxyInB 。

   这里推荐的资源名称，如VideoProxyInA和MediaProfileA，旨在帮助明确各种资源之间的关系。但是，在您自己的项目中，我们建议使用更能描述媒体代理和媒体束需要处理的内容类型的名称。这些资源名称在您的配置中以及像 媒体采集（Media Capture） 窗口这样的地方是可见的，因此理想情况下，它们应该对您项目的整个团队都有意义。

8. 从主菜单中，选择 编辑（Edit）> 项目设置（Project Settings） 。找到 插件（Plugins）> 媒体配置文件（Media Profile） 部分，并展开高级选项。

9. 向 媒体源代理（Media Source Proxy） 列表添加两个条目。将其中一个条目设置为引用 VideoProxyInA ，另一个设置为引用 VideoProxyInB 。
   

10. 现在，我们将创建一个名为 FileProfile 的新媒体配置文件，它可以从磁盘上的文件中播放视频。有两种方法可以做到这一点：

    • 在 内容浏览器（Content Browser） 中右键单击，从上下文菜单中选择 媒体（Media）> 媒体配置文件（Media Profile） ，然后重命名资源。
      

    • 从工具栏中的配置文件选择按钮中，选择 新建媒体配置文件（Create New Media Profile） ，并为新资源设置路径和名称。
      

11. 如果新的媒体配置文件没有自动打开以进行编辑，双击它进行编辑。
    找到 媒体源（Media Sources） 设置，并向列表添加两个新元素。将列表中的各个条目设置为 文件媒体源（File Media Source） ，并为每个条目设置不同的 文件路径（File Path） 。
    
    

    如果您需要一些示例视频来测试，可以使用以下这些： Video1 | Video2

12. 重复前面的步骤以创建第二个媒体配置文件，名为 LiveFeedProfile ，它从连接您计算机的AJA或Blackmagic设备导入视频。例如：
    各个媒体配置文件还提供了设置时间码提供者和集中同步提供者的功能：
    
    它们与 项目设置（Project Settings） 面板中提供的 时间码提供者（TimecodeProvider） 和 自定义时间步（Custom TimeStep） 设置具有完全相同的效果。但是，当您在媒体配置文件中设置这些值时，只有当该媒体配置文件处于活动状态时，它们才会覆盖 项目设置（Project Settings） 。详情请参阅 时间码和集中同步 。

13. 使用工具栏中的配置文件选择按钮选择上面创建的 FileMediaProfile 。
    

14. 将您的两个媒体束拖放到关卡视口中。您应该看到它们开始显示从文件加载的视频或通过SDI连接传入的视频。
    

15. 现在，您可以使用工具栏中的媒体配置文件选择工具在两个媒体配置文件之间轻松切换，只需单击一次即可更改媒体源（也可选择更换时间码和集中同步设置）。
    

使用代理媒体输出

在这个过程中，我们将扩展上一节中创建的媒体配置文件（Media Profile）设置。我们将在虚幻编辑器（或运行时的虚幻引擎）中采集一个视频源，并将该内容通过代理媒体输出路由到我们在媒体配置文件中定义的输出配置。整个过程与设置媒体源非常相似：创建一个代理资源，更新项目设置以引用代理，并在媒体配置文件中配置实际的输出设备。

1. 首先创建一个代理媒体输出资源。在 内容浏览器（Content Browser） 中右键单击，从上下文菜单中选择 媒体（Media）> 代理媒体输出（Proxy Media Output） 。
   
   将新资源命名为 VideoProxyOut 。

2. 从主菜单中，选择 编辑（Edit）> 项目设置（Project Settings） 。找到 插件（Plugins）> 媒体配置文件（Media Profile） 部分，并展开高级选项。
   

3. 向 媒体输出代理（Media Output Proxy） 列表添加一个条目，并将其输出代理设置为指向 VideoProxyOut 。
   
   

4. 双击您在上一节中创建的 LiveFeedProfile ，并将一个新条目添加到 媒体输出（Media Output） 列表中。将其设置为将视频源发送到连接到您计算机的AJA或Blackmagic设备上的端口。
   

5. 从主菜单选择 窗口（Window）> 媒体采集（Media Capture） 。

6. 如果需要，向 视口采集（Viewport Capture） 列表添加一个新条目，并将其 媒体输出（Media Output） 设置为指向您的 VideoProxyOut 资源。
   

7. 单击 采集（Capture） 开始采集内容，并通过代理将其发送到您的AJA或Blackmagic设备。
   如果您此时将当前媒体配置文件切换到 FileVideoProfile ，则采集将停止，因为 FileVideoProfile 的 媒体输出（Media Outputs） 列表中没有为条目0配置输出。

8. 要在运行时采集视频源并通过代理发送它，请完全遵循AJA媒体或 Blackmagic Design 硬件的快速入门指南进行操作。
   唯一的区别是，您使用要将采集发送到的 ProxyMediaOutput 的对象引用，而不是使用一个作为 AjaMediaOutput 或 BlackmagicMediaOutput 的对象引用变量。然后使用这个 ProxyMediaOutput 变量作为 创建媒体采集（Create Media Capture） 节点的输入。例如：
   

最终结果

现在已经设置了两个不同的媒体配置文件，每个配置文件都有自己的输入和输出内容配置。它们都使用媒体代理资源将这些输入和输出配置映射到使用或生成这些视频源的其他媒体框架资源。此示例配置可能与您的实际使用场景不匹配。但是，在完成了它的设置步骤之后，您应该对如何扩展相同的基本功能来满足自己的需求有了较好的了解。