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

默认情况下，虚幻编辑器会根据计算机上的当前系统时间生成自己的时间码。该时间码默认设置为每秒30帧，但是引擎在任何给定秒内渲染的帧数通常都超过了30帧。因此，通常会为输出中的多个连续帧指定相同的时间码值。

当您处理专业视频时，您经常需要在多个不同的视频源和信号处理设备之间保持时间码的同步。要做到这一点，您可能需要使虚幻引擎的时间码与您正在处理的视频源的时间码匹配。在某些情况下，您可能想更进一步，锁定引擎，以便引擎仅为通过引用输入得到的每个视频帧生成一个帧，我们称之为*集中同步*。

本页介绍如何使虚幻引擎采用来自您在AJA卡上指定的端口的时间码值（而不是生成自己的时间码），以及如何将虚幻引擎集中同步到该时间码信号。

在虚幻编辑器中显示时间码

当您在虚拟编辑器中工作时，要查看虚幻引擎使用的实际时间码值，请使用 时间码提供者（Timecode Provider） 面板。您可以在主菜单的 窗口（Window）> 开发者工具（Developer Tool） > 时间码提供者（Timecode Provider） 下找到该面板。

它显示当前时间码、时间码提供者（时间码值的来源）和每秒生成的时间码帧数。您可以将该面板停靠在主关卡编辑器的UI中的任何位置。

或者，您可以使用以下控制台命令：

stat timecode

您将看到以 时分秒帧（HH:MM:SS:FF） 格式印在虚幻编辑器视口中的值：

如果您已经将虚幻引擎设置为采用来自输入信号的时间码，或集中同步到视频信号，您还将看到时间码和集中同步源代码。例如：

您可以使用该命令来确认虚幻引擎正在以您期望的速率生成帧，并且它使用与输入视频相同的时间码值。

设置时间码和集中同步

下面的步骤显示了如何使虚幻引擎采用来自AJA或Blackmagic设备的输入SDI视频源的时间码值，以及如何使虚幻引擎将其帧率锁定到该来源，以便它仅为每个输入帧生成一个输出帧。

1. 右键单击内容浏览器，并选择 创建基础资源（Create a Basic Asset）> 蓝图类（Blueprint Class） 。
   

2. 在 选择父类（Pick Parent Class） 窗口中，展开 所有类（All Classes） 部分(1)。搜索并选择 AjaTimecodeProvider 类（如图）或 BlackmagicTimecodeProvider 类(2)，然后单击 选择（Select） (3)。
   
   回到内容浏览器中，为新资源提供一个描述性名称，，例如 AJA_Timecode_Port 或 Blackmagic_Timecode_Port 。

3. 双击新资源以在蓝图编辑器中打开它，并在 详细信息（Details） 面板中设置属性。

   • 要从传入视频流读取时间码，请设置 视频配置（Video Configuration） 或 媒体配置（Media Configuration） 以指向AJA或Blackmagic卡上的端口，并设置要从源（LTC或VITC）读取的时间码类型（如果适用）。

   • 如果您使用的是AJA卡，想要从该卡上的引用端口而不是从视频流读取时间码，请启用 Use Reference In ，并设置 引用配置（Reference Configuration） ，而非 视频配置（Video Configuration） 。

4. 编译（Compile） 并 保存（Save） 蓝图类，并关闭蓝图编辑器。

5. 如果您想将虚幻引擎集中同步到您的视频源，请重复前面的操作说明创建并设置另一个蓝图类，但这次使用 AjaCustomTimeStep 或 BlackmagicCustomTimeStep 作为父类。
   

6. 该类需要类似 AjaTimecodeProvider 或 BlackmagicTimecodeProvider 的设置：
   
   AJA卡还提供额外的设置；详细信息，请参阅提示文本。
   

7. 从主菜单选择 编辑（Edit）> 项目设置（Project Settings） 。
   在 项目设置（Project Settings） 窗口中，打开 引擎（Engine）> 常规设置（General Settings） 类别(1)，找到 时间码（Timecode） 部分(2)。从 时间码提供者（TimecodeProvider） 下拉列表中，选择创建的时间码端口资源。
   

8. 如果您想要将虚幻引擎同步集中到您的视频源，找到上面的 帧率（Framerate） 部分，并在该部分底部展开高级属性。从 自定义时间步（Custom TimeStep） 下拉列表中，选择创建的集中同步端口资源。
   

9. 关闭虚幻编辑器并重新启动项目。

最终结果

只要您有视频输入传入到您为时间码提供者类和自定义时间步类设置的端口，且该视频具有您指定的分辨率、帧率和时间码格式，虚幻引擎应该就会采用您的视频的时间码并锁定其帧更新频率，以便它为每个输入帧生成一个输出帧。

要验证是否如此，使用 在虚幻编辑器中显示时间码 中描述的选项之一。

时间码纹素编码

出于调试目的，AJA和Blackmagic设备的媒体源和媒体输出资源可以通过用白色照亮像素将每帧的时间码编码到视频图像中。如果您需要一种可视化的方法来验证给定的视频帧是否与它所对应的时间码信号匹配，那么该功能可以十分有用。

时间码通常以 时分秒帧（HH:MM:SS:FF） 格式表示，共8位数。从图像的顶部开始，在纹理输出中为每个数字指定一行。在每一行中，从图像的左边到时间码数字的值进行计数，以找到表示时间码值的像素。最左边的像素为0号像素。

例如，假定时间码值为12:08:44:12:

• 在第一行，左起第二个像素被照亮（1号像素）。

• 在第二行，左起第三个像素被照亮（2号像素）。

• 在第三行，最左边的像素被照亮（0号像素）。

• 在第四行，左起第九个像素被照亮（8号像素）。

• 以此类推。