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

用户可以通过 Live Link 流送来自各种源头的数据，并将这些数据直接用于关卡中的Actor。为了改进此流程， 虚幻引擎4 (UE4) 发展出了一些精心设计的功能，可以简化将Live Link数据用于关卡中Actor的过程。

• Live Link预设（Live Link Presets） 能保存数据源的设置，供以后使用。

• LiveLink控制器组件（LiveLink Controller Component） 允许你启用LiveLink控制器。它们能简化将Live Link信息用于Actor的过程，我们还添加了几个蓝图节点以方便收集这些数据。

• LiveLink骨骼动画组件（LiveLink Skeletal Animation Component） 能公开 OnLiveLinkUpdated 事件节点，该节点会在每次Live Link更新时检索有关对象和数据源的信息，并可通过蓝图执行很多其他功能。

有关启用Live Link和设置连接的更多信息，请参见 Live Link插件 文档。

Live Link预设

UE4从 Live Link连接 窗口中创建的各种数据源获取Live Link数据。创建后，这些数据源可以保存为 预设（Presets） ，并可使用 Apply to Client 节点通过蓝图访问这些数据源。

可以利用此节点在应用程序启动时加载Live Link预设。

Live Link组件

Live Link骨骼动画组件

当你从 组件（Components） 面板为Actor的蓝图添加Live Link骨骼动画组件后，该组件不会成为其他组件的子节点。它会单独保存在你的蓝图内，使你可以访问 On Live Link Updated Event 。

每次更新组件（包括编辑器内）时都会触发On Live Link Updated事件。

On Live Link Updated本质上能取代你的 更新事件（Tick Event） ，不同点在于，它还可以在编辑器内运行。例如，如果你希望在编辑器内实时驱动一些数据，则可以使用此节点。

Live Link控制器组件

Live Link控制器组件位于角色蓝图中，允许你使用Live Link控制器。这些控制器会自动从Live Link对象获取数据，并通过Live Link控制器将这些数据应用到Actor中对应的组件。

使用Live Link控制器

Live Link控制器能快速获取Live Link数据，并流送给场景中的Actor。每个控制器都会读取来自Live Link对象的数据，并自动应用到你选择的Actor身上。根据情况，控制器分为三种不同种类：

• 变换（Transform）

• 摄像机（Camera）

• 光源（Light） 有关这些不同的Live Link控制器的详细信息，请见下文。

变换

变换控制器能从Live Link对象快速捕获变换数据，并将这些数据应用于关卡中的Actor。

此控制器提供以下选项：

设置	说明
世界变换（World Transform）	将组件的变换设置为世界空间。取消选中则意味着设置为本地空间。
使用缩放（Use Scale）	使用来自Live Link的缩放数据。
扫描（Sweep）	扫描根组件并检查阻挡碰撞，沿途触发重叠，如果阻挡，则会在未达目标时停止。
传送（Teleport）	传送物理状态（如果启用了物理碰撞）。 如果选中，则物理速度保持不变。 如果未选中，则基于位置变化更新物理速度。

摄像机

摄像机控制器会将Live Link对象中的摄像机设置和移动数据以及摄像机角色直接应用到你关卡中的摄像机Actor。

可以做动画处理的摄像机设置包括：

• 视野（以角度为单位）

• 长宽比（宽/高）

• 焦距

• 以F值计算的摄像机孔径

• 摄像机焦距（厘米）（仅手动聚焦）

• 摄像机投影模式（视角、正交等）

光源

光源控制器将Live Link对象中的光源设置以及光源角色直接应用到你关卡中的光源Actor。

可以做动画处理的光源设置包括：

• 色温（开氏）。

• 总能量（勒克斯值）。

• 滤色。

• 内锥角（聚光源的角度）。

• 外锥角（聚光源的角度）。

• 光源可见影响（适用于点光源和聚光源）。

• 光源形状的软半径（适用于点光源和聚光源）。

• 光源形状的长度（适用于点光源和聚光源）。

将控制器应用于Actor

要应用Live Link控制器，首先将Live Link控制器组件添加到你的Actor：

通过 细节（Details） 面板使用以下步骤添加组件：

1. 选择关卡中的 Actor 。

2. 在 细节（Details） 面板中，点击 +添加组件（+ Add Component） 按钮，并搜索 Live Link控制器（Live Link Controller） 组件。

3. 添加后，从组件列表选择该组件，打开 对象表示（Subject Representation） 下拉菜单。从列表中选择要作为此Actor数据源的对象。虚幻将基于你的选择为你选择 要控制的组件（Component to Control） 。必要时可以调整。

设置控制器后，你的Actor将开始从选定Live Link对象自动接收数据。

常见蓝图节点

可以通过各种蓝图节点访问Live Link数据。

Get Live Link Subjects

有时你需要获取一个对象列表才能使用 Evaluate Live Link Frame 节点。这种情况下，你可以使用 Get Live Link Subjects ：

这将返回Evaluate Live Link Frame函数认为有效的一组对象。

Evaluate Live Link Frame

调用Evaluate Live Link Frame函数可以获取与所提供的对象名称关联的Live Link数据。此函数提供当前帧是否有效的执行引脚，以及可以从 数据结果（Data Result） 输出中访问的静态和帧数据。此数据由选择用于评估对象的角色类型所确定。

下例显示直接从数据结构引脚访问的数据。

使用来自Evaluate Live Link Frame的数据

Evaluate Live Link Frame可以使用多个蓝图函数评估所提供的数据。结果数据取决于评估的角色。评估动画角色时，会看到以下内容：

• Get Basic Data

• Get Curves

• Get Metadata

• Get Root Transform

• Get Transform by Index

• Get Transform by Name

• Number of Transforms

• Transform Names

Get Basic Data

Get Basic Data 节点将返回当前对象帧中所存对象的基本结构。

Get Curves

Get Curves 函数可以获取所有混合形状（Blend Shape）或动画曲线（Animated Curve），并将名称映射返回到各个条目的值。

你可以使用 查找（Find） ，并输入一个名称（Name）以检索某个曲线的值（或使用布尔值确定是否找到了该值）。

Get Metadata

Get Metadata 函数返回对象帧中存储的对象元数据结构，你可拆分该结构以检索信息：

字符串元数据是指定字符串在对象上的映射，例如你可能需要将某个要流送对象的类型作为一个指定字符串传递。元数据还包括 场景时间码（Scene Timecode） 和 场景帧率（Scene Framerate） ，你可拆分其结构以获取所需信息。

输出	说明
字符串元数据（String Metadata）	指定字符串的映射，用于提供有关某个帧或对象的额外信息，例如"类型（Type）"："摄像机（Camera）"。
场景时间码（Scene Timecode）	与当前帧关联的时间码值。 并不保证其唯一性，例如在MotionBuilder中编辑单个帧会导致为多个帧发送该帧的时间码。
场景帧率（Scene Framerate）	场景时间码对应的帧率。

Get Root Transform

Get Root Transform 函数将对象帧的根变换以Live Link变换的形式返回（如果没有变换，则返回身份）。

这将返回一个Live Link变换而非标准变换，因为可以在上面调用其他函数（下文中介绍）：

函数	说明
子计数（Child Count）	返回给定Live Link变换的子项数。
组件空间变换（Component Space Transform）	返回给定Live Link变换（相对于你的型号的根）的根空间中的变换值。
获取子项（Get Children）	返回给定Live Link变换的子Live Link变换数组。
获取父项（Get Parent）	如果存在父项，返回父Live Link变换，如果不存在父项，返回身份变换。
有父项（Has Parent）	返回给定Live Link变换是否有父变换。
父骨骼空间变换（Parent Bone Space Transform）	返回给定Live Link变换的父空间中的变换值（它的内部存储方式，并无论父骨骼如何，均与之相关联）。
变换名称（Transform Name）	返回给定Live Link变换的名称。

Get Transform By Index

Get Transform By Index 函数返回指定索引处的某个对象帧中存储的Live Link变换（如果变换索引无效，此函数返回一个身份变换）。

Get Transform by Name

按名称获取变换（Get Transform by Name） 函数类似于 按索引获取变换（Get Transform by Index） ，但获取变换名称（Transform Name）数据。

Number of Transforms

Number of Transforms 函数这将返回对象帧内的变换数。

其中一种使用情况是与 按索引获取变换（Get Transform By Index） 结合使用，以循环并检索你的每个Live Link变换（类似于下例）：

Get Transform Names

Get Transform Names 函数返回某帧中所有变换的名称数组。

使用蓝图应用Live Link预设

蓝图与Live Link的一个常见用法是，在运行时使用 Apply to Client 节点将Live Link预设分配到骨骼网格体：

1. 首先在Live Link面板中创建Live Link预设。有关预设的更多信息，请参见 Live Link插件 文档。

2. 在角色蓝图中新建变量，在 Details 面板中将 变量类型（Variable Type） 设置为 Live Link预设（Live Link Preset） ，从而创建预设的引用。

3. 编译你的蓝图，将新变量的默认值设置为你保存的Live Link预设。

4. 将该变量拖到你的蓝图中，并从菜单中选择 获取（Get） 。

5. 从该变量拖开引线，并搜索 Apply to Client 节点。

6. 将 Event Begin Play 节点连接到 Apply to Client 。