现在可以使用 Control Rig组件（Control Rig Component） 在蓝图中调用 Control Rig 。使用此组件，你可以使用蓝图中的Gameplay逻辑驱动Control Rig，重新初始化Control Rig，以便适应不同比例的角色，并将非骨骼网格体对象附加到Control Rig层级。
本文档概述了Control Rig组件、如何将其添加到你的蓝图，以及它启用的功能。
先决条件
- 你已经为角色创建Control Rig资产，并且知道如何创建功能按钮。有关如何执行此操作的信息，请参阅 Control Rig快速入门指南 页面。
- 你已经创建包含骨骼网格体组件的 Actor蓝图（Actor Blueprint） ，并且了解 蓝图可视化脚本 。
组件设置
点击蓝图组件（Blueprint Components）面板中的 添加（Add）（+） 按钮，并在 动画（Animation） 类别中，选择 Control Rig ，可以创建 Control Rig组件 。
然后，选择 Control Rig组件（Control Rig Component） ，并在 细节（Details） 面板中，指定你的默认 Control Rig类（Control Rig Class） 。点击Control Rig类（Control Rig Class）旁边的下拉菜单，并指定你的类。
指定Control Rig类（Control Rig Class）后，Control Rig中的骨骼将在视口中可见。在Control Rig组件细节（Control Rig Component Details）面板中，禁用 绘制骨骼（Draw Bones） ，你可以隐藏这些骨骼。
映射设置
最后，你需要将Control Rig 映射 到骨骼网格体，这必须在Control Rig组件（Control Rig Component）的 初始化前事件（Pre Initialize Event） 上完成。这样做是为了在 骨骼网格体组件（Skeletal Mesh Component） 和 Control Rig组件（Control Rig Component） 之间形成连接。
选择Control Rig组件（Control Rig Component）后，点击细节（Details）面板中 初始化前（On Pre Initialize） 旁边的 添加（Add）（+） 按钮。这样将在事件图表（Event Graph）中创建相应的事件。
然后，从 组件（Component） 引脚拖动，并从上下文菜单中，选择 添加映射骨骼网格体（Add Mapped Skeletal Mesh）。添加对骨骼网格体组件（Skeletal Mesh Component）的引用，并将其连接到 骨骼网格体组件（Skeletal Mesh Component） 引脚。
概述
完成组件设置后，你就可以开始在蓝图中使用Control Rig组件（Control Rig Component）。借助它，你可以使用基本功能，例如获取或设置 Rig元素、编辑细节并创建新的映射连接。
细节
以下是Control Rig组件（Control Rig Component）的相关细节列表：
| 名称 | 说明 |
|---|---|
| Control Rig类（Control Rig Class） | 要实例化的Control Rig类。此处必须指定Control Rig资产。 |
| 映射元素（Mapped Elements） | 此数组用于手动定义Control Rig的默认映射 |
| 更新函数前重置变换（Reset Transform Before Tick） | 启用此选项将导致Control Rig变换在每次更新函数之前更新。 |
| 设置前重置初始值（Reset Initials Before Setup） | 启用此功能将导致骨骼（Bones）、空值（Nulls）和功能按钮（Controls）上的初始变换在 设置事件（Setup Event） 之前重置。 |
| 每次更新函数时更新Rig（Update Rig on Tick） | 启用此选项，可以确保在组件更新函数声时更新Rig。 |
| 在编辑器中更新（Update in Editor） | 允许Control Rig行为在视口中可见，而无需运行或模拟。 |
| 启用惰性求值（Enable Lazy Evaluation） | 启用此选项将使Control Rig仅求值任何映射输入是否已更改。 |
| 位置阈值（Position Threshold） | 启用 惰性求值（Lazy Evaluation） 时要使用的位置或平移阈值。 |
| 旋转阈值（Rotation Threshold） | 启用 惰性求值（Lazy Evaluation） 时使用的旋转阈值（以度为单位）。 |
| 比例阈值（Scale Threshold） | 启用 惰性求值（Lazy Evaluation） 时使用的比例阈值。 |
| 绘制骨骼（Draw Bones） | 启用从 Control Rig类（Control Rig Class） 导入的绘制骨骼。  |
事件
Control Rig可以从Control Rig组件调用以下事件。选择Control Rig组件（Control Rig Component ），并找到细节（Details）面板中的 事件（Events） 类别，或在事件图表（Event Graph）中点击右键，并选择 添加Control Rig事件（Add Event for Control Rig）>Control Rig ，可以将这些事件添加到事件图表（Event Graph）中。
| 名称 | 图像 | 说明 |
|---|---|---|
| 在初始化前（On Pre Initialize） |  |
在组件的Control Rig初始化之前调用此事件。此事件可用于在初始化Control Rig组件之前，在Control Rig中设置变换或其他变量。在标准的Control Rig设置中，此事件会触发一次，类似于事件开始运行（Event Begin Play）。 |
| 初始化后（On Post Initialize） |  |
在组件的Control Rig初始化后调用此事件。此事件可用于在初始化Control Rig组件之后在Control Rig中设置变换或其他变量。在标准的Control Rig设置中，此事件会触发一次，类似于事件开始运行（Event Begin Play）。 |
| 设置前（On Pre Setup） |  |
在组件Control Rig的设置事件（Setup Event）之前调用此事件。此事件可用于在Control Rig的设置事件之前，在Control Rig中设置变换或其他变量。在标准的Control Rig设置中，此事件会触发一次，类似于事件开始运行（Event Begin Play）。 |
| 设置后（On Post Setup） |  |
在组件Control Rig的设置事件（Setup Event）之后调用此事件。此事件可用于在Control Rig设置事件之后，在Control Rig中设置变换或其他变量。在标准的Control Rig设置中，此事件会触发一次，类似于事件开始运行（Event Begin Play）。 |
| 正向解算前（On Pre Forwards Solve） |  |
在组件Control Rig的正向解算（Forward Solve）之前调用此事件。此事件可用于在正向解算之前，在Control Rig中设置变换或其他变量。在标准的Control Rig设置中，此事件会持续触发，类似于事件更新函数（Event Tick）。 |
| 正向解算后（On Post Forwards Solve） |  |
在组件Control Rig的正向解算（Forward Solve）之后调用此事件。此事件可用于在正向解算之后，在Control Rig中设置变换或其他变量。在标准的Control Rig设置中，此事件会持续触发，类似于事件更新函数（Event Tick）。 |
映射
在设置阶段，你需要将整个骨骼网格体组件（Skeletal Mesh Component）映射到Control Rig组件。但是，你也可以将Control Rig中的特定元素映射到其他组件。映射是双向的，这意味着Control Rig元素可以影响组件，也会受其影响。这样，映射有点类似于连接。
默认情况下，映射通常是通过将 Control Rig类（Control Rig Class） 中的骨骼名称匹配到 骨骼网格体组件（Skeletal Mesh Component） 来实现。通过这种方式，你可以想象当两个组件都在使用中时，你的蓝图中有两个不同的骨架在运行。映射允许这些骨架以及其他组件相互影响。
映射元素可以通过以下方式完成：
手动细节映射
在 细节（Details） 面板的 动画（Animation） 分段下，Control Rig组件有 映射元素（Mapped Elements） 数组。点击 添加（Add）（+） 按钮，你可以手动添加信息，以便将元素映射并连接到Control Rig。
例如，如果你想在你的蓝图中映射摄像机组件，以便功能按钮影响它的位置，那么输入以下属性：
- 将 组件名称（Component Name） 设置为 摄像机（Camera） ，使其与摄像机组件（Camera Component）匹配。
- 将 元素类型（Element Type） 设置为 功能按钮（Control） ，因为这是你要映射到的目标Control Rig元素。
- 将 元素名称（Element Name） 设置为 Camera_ctrl ，这是你要映射到的目标Control Rig元素（Control Rig Element）的名称。
- 将 方向（Direction） 设置为 输出（Output） ，以便定义映射方向。在此案例中，输出导致Control元素指示摄像机的变换。如果指定了 输入（Input） ，则摄像机组件将改为指定Control元素。
以下属性可以用于创建映射设置。
| 名称 | 说明 |
|---|---|
| 组件引用（Component Reference） | 要按名称定义的蓝图组件。如果Control Rig组件在基于Actor的蓝图中，在未指定名称的情况下，它默认为 Self 作为引用Actor。 |
| 变换索引（Transform Index） | 具有多个变换的组件的可选索引值。 |
| 变换名称（Transform Name） | 具有多个个性化变换名称的组件的可选名称值，例如骨骼网格体中的套接字。 |
| 元素类型（Element Type） | 组件是其输入或输出的Control Rig中的Rig元素类型。你可以从骨骼（Bones）、功能按钮（Controls）、空值（Nulls）、曲线（Curves）、刚体（Curves）和引用（References）中进行选择。 |
| 元素名称（Element Name） | 组件是其输入或输出的Control Rig中的Rig元素名称。 |
| 方向（Direction） | 确定映射蓝图组件和Control Rig元素之间的控制方向。
|
| 偏移（Offset） | 要应用于映射的变换偏移。 |
| 权重（Weight） | 映射因子。 |
| 空间（Space） | 应该在它上面定义映射的变换空间。 |
动态图表映射
你还可以在事件图表（Event Graph）中动态添加或更改映射。此步骤通过几个不同的函数和结构体完成，以实现不同级别的映射。
添加映射骨骼网格体
该节点采用骨骼网格体组件，并将骨骼网格体的骨骼映射到Control Rig组件中使用的Control Rig中的预览网格体。这是Control Rig到骨骼网格体的映射连接。通常在蓝图中执行Control Rig的初始化时使用此节点。
添加映射骨骼网格体骨骼数组
此节点在骨骼网格体组件和Control Rig组件之间映射 骨骼（Bones） 或 曲线（Curves） 数组。此外，如果Control Rig骨架和骨骼网格体骨架的骨骼或曲线名称彼此不同，你可以指定 源（Source） 和 目标（Target） 名称。这提供了与"查找和替换（Find and Replace）"名称类似的工作流程，但它仅适用于单独的骨骼或曲线。
仅来自任一数组的骨骼或曲线将被映射。如果你也想映射整个骨架，那么你可以使用添加映射骨骼网格体跟随此节点。
添加映射元素
此节点将蓝图组件数组映射到Control Rig组件。这些组件由 Make ComponentReference 和 Make ControlRigComponentMappedElement 结构体定义。这些结构体的属性和格式与从细节面板映射时相同。
添加映射组件
此节点将蓝图组件数组映射到Control Rig组件。这些组件通过直接引用组件和 Make ControlRigComponentMappedComponent 结构体来定义。此结构体的属性是 Make ControlRigComponentMappedElement 的简化变体，仅提供最常见的映射属性。
