> For the complete documentation index, see [llms.txt](https://docs.convai.com/api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/blueprint-reference/data-types-and-enums.md).

# 数据类型和枚举

Convai Unreal Engine 插件中 Blueprint 暴露的结构体和枚举参考，包括对象条目、动作类型、情绪和连接状态。

此处记录了 Convai Blueprint API 中所有作为参数或返回类型出现的结构体和枚举。当某个引脚需要 `FConvaiObjectEntry`、 `EC_RunLLMOption`或其他共享类型时，可将此页面用作查询参考。

### 对象和环境类型

这些类型表示世界中的 `Actor`、会话开始时发送给 Convai 的环境约定，以及用于跟踪属性、让 Convai 了解运行时状态变化的系统。

#### FConvaiObjectEntry

一个 `Actor` 引用，包含身份、描述和导航目标数据。该类型贯穿整个环境 API：用于 `FConvaiEnvironmentData.Objects`, `FConvaiEnvironmentData.Characters`中，作为 `ConversationPartner` 用于 `UConvaiChatbotComponent`上，以及作为结果操作中类型为 `Reference` 的参数值。

| 字段                                                                  | 类型                                | 默认值           | 说明                                                                                            |
| ------------------------------------------------------------------- | --------------------------------- | ------------- | --------------------------------------------------------------------------------------------- |
| `Ref`                                                               | `TWeakObjectPtr<AActor>`          | `nullptr`     | 此条目所引用的 `Actor` 。                                                                             |
| `OptionalPositionVector`                                            | `FVector`                         | `(0, 0, 0)`   | **已弃用。** 自动写入的已解析目标位置快照。请勿手动设置。实时世界坐标请改用 `Resolve Goal Location`的 `Out Goal Location` 输出。     |
| `Name`                                                              | `FString`                         | `""`          | 发送给 Convai 的显示名称。在聊天机器人的环境中，所有对象和角色的名称必须唯一。                                                   |
| `Description`                                                       | `FString`                         | `""`          | 对该 `Actor` 的自然语言描述——AI 应当了解的相关信息。                                                             |
| `ObjectReference` （蓝图显示名称 `Object Is`)                              | `EConvaiObjectReference`          | `Whole Actor` | 该 `Actor` 算作此对象的内容——整个对象，或其中的某个特定组件。控制角色关注该对象时看向哪里，以及在 `MovementPoints` 为空时走向哪里。              |
| `ComponentName`                                                     | `FString`                         | `""`          | 与 `Actor`的组件进行不区分大小写的子字符串匹配，当 `ObjectReference` 为 `Specific Component`时使用。留空则使用 `Actor`自身的位置。 |
| `SocketOrBoneName`                                                  | `FName`                           | `None`        | 匹配组件上用作目标点的插槽或骨骼。若未找到，则回退到组件原点。仅当 `ObjectReference` 为 `Specific Component`.                   |
| `AcceptanceRadius`                                                  | `float` （厘米）                      | `150.0`       | 角色必须在多少厘米范围内才算到达。精确目标（如门把手）使用较小值，较大的物体（如车辆）使用较大值。                                             |
| `MovementPoints`                                                    | `TArray<FConvaiMovementPoint>`    | `[]`          | 由设计人员为此对象指定的目的地，例如门两侧各设一个点。为空时，角色会走向对象本身，位置通过 `ObjectReference`.                              |
| `Use Object as Fallback` (`bFallbackToObjectWhenPointsUnreachable`) | `bool`                            | `false`       | 当所有 `MovementPoints` 条目均无法到达时，改为走向对象本身，而不是报告对象无法到达。默认关闭。                                      |
| `ResolvedComponent`                                                 | `TWeakObjectPtr<USceneComponent>` | —             | **仅输出。** Convai 使用 `ComponentName`解析出的组件。动作到达时由插件填充。请勿手动设置此字段。                                |

{% hint style="info" %}
`ResolvedComponent` 由插件在运行时填充；如果组件被销毁，则会清空。收到动作后，可在 Blueprint 中读取此字段以直接访问解析出的组件（例如附加效果、读取其变换等）。
{% endhint %}

#### EConvaiObjectReference

一个 `FConvaiObjectEntry`的引用所指向的内容——对象本身。用于限定凝视/注意力范围、视觉标记，以及在未指定 `MovementPoints` 时作为移动目标的后备选项。当条目中指定了 `MovementPoints` 时，它们将成为移动目标，而 `ObjectReference` 仅用于定义对象是什么。

| 值                   | 显示名称          | 说明                                                                                     |
| ------------------- | ------------- | -------------------------------------------------------------------------------------- |
| `WholeActor`        | `Whole Actor` | 整个 `Actor` 是目标对象。视线检测会匹配其任意基本图元；移动回退逻辑会在 Actor 的边界处停止。                                 |
| `SpecificComponent` | `特定组件`        | Actor 上的子组件 `Actor` 是目标对象（设置 `ComponentName`，也可以设置为插槽或骨骼）。视线检测仅匹配该组件；移动回退逻辑会以其世界位置为目标。 |

#### EConvaiMovementPointAttachment

如何解释 `FConvaiMovementPoint`的变换。

| 值                   | 显示名称     | 说明                                                                   |
| ------------------- | -------- | -------------------------------------------------------------------- |
| `RelativeToObject`  | `相对于对象`  | 点的变换相对于对象，因此会随目标移动 `Actor`；当 `ObjectReference` 限定为组件时，则会随特定组件移动。默认值。 |
| `KeepWorldPosition` | `保持世界位置` | 点的变换使用绝对世界坐标，即使对象移动，点也会保持原位。                                         |

#### FConvaiMovementPoint

由设计人员设置的移动访问点，例如角色移动到对象旁时应站立的位置；比如门的两侧各设一个点。它仅包含数据，可通过 `UConvaiObjectComponent` 上的视口可视化工具或直接在“细节”面板中编辑。解析器会选择可到达且步行路径最短的点。

| 字段                                               | 类型                               | 默认值     | 说明                                                                                            |
| ------------------------------------------------ | -------------------------------- | ------- | --------------------------------------------------------------------------------------------- |
| `Transform`                                      | `FTransform`                     | —       | 选择此点时角色站立的位置。只有位置会影响移动；旋转会被存储且可编辑，但目前保留供未来控制朝向之用。                                             |
| `Attachment`                                     | `EConvaiMovementPointAttachment` | `相对于对象` | 点是随对象移动，还是固定在世界中。                                                                             |
| `bEnabled` （蓝图显示名称： `已启用`)                       | `bool`                           | `true`  | 取消勾选即可停用此点，而无需删除它。如果对象上的所有点都已禁用，则对象的行为就如同没有设置任何点一样——角色会走到对象本身旁边。                              |
| `bCreatesSeparateDestination` （蓝图显示名称： `创建独立目标`) | `bool`                           | `false` | 启用后，此点会成为一个独立目标，可供 AI 前往，目标地址格式为 `"<Object> <Destination Name>"`。禁用后，此点只是 AI 前往对象本身时可站立的位置之一。 |
| `Name` （蓝图显示名称： `目标名称`)                          | `FString`                        | `""`    | 独立目标的名称。仅当 `bCreatesSeparateDestination` 启用时使用。                                               |

#### FConvaiEnvironmentData

会话开始时发送给 Convai 的完整动作能力约定，作为 `action_config`。可在 `UConvaiChatbotComponent.EnvironmentData` 中通过 Details 面板填充，或在运行时使用聊天机器人组件上的 `Add/Remove/Clear` 方法修改。

| 字段                       | 类型                           | 默认值                                            | 说明                                                      |
| ------------------------ | ---------------------------- | ---------------------------------------------- | ------------------------------------------------------- |
| `bEnableActions`         | `bool`                       | `true`                                         | 总开关。当 `false`时，不会发送 `action_config` ，并且会忽略所有其他字段。       |
| `Actions`                | `TArray<FConvaiAction>`      | `Move To`, `Follow`, `Stop Moving`, `Wait For` | 角色可执行的物理动作。                                             |
| `Objects`                | `TArray<FConvaiObjectEntry>` | `[]`                                           | 角色可以引用或移动到的世界对象。                                        |
| `Characters`             | `TArray<FConvaiObjectEntry>` | `[]`                                           | 角色可以与之交互的其他角色或 NPC。                                     |
| `CurrentAttentionObject` | `FConvaiObjectEntry`         | —                                              | 当前聚焦的对象 — Convai 用它来解析代词指代（`"this"`, `"that"`, `"it"`). |

#### FConvaiTrackedProperty

所属 `Actor` 上的属性， `UConvaiObjectComponent` 会监视该属性并向所有聊天机器人报告。AI 会在会话开始时收到当前值，并在值发生变化时再次收到更新。

| 字段                       | 类型                                             | 默认值     | 说明                                                                                                          |
| ------------------------ | ---------------------------------------------- | ------- | ----------------------------------------------------------------------------------------------------------- |
| `PropertyPath`           | `FName`                                        | —       | 指向 `Actor` 上该值的点分隔路径（例如 `"bActive"`, `"Stats.HP"`, `"GetCurrentRoomName"`）。使用 Details 面板中的 Bind 按钮，从属性树中选择。 |
| `Description`            | `FString`                                      | `""`    | 用通俗易懂的语言描述此属性对 AI 的含义（例如 `"Whether the player has activated this switch"`).                                 |
| `StateValueDescriptions` | `TArray<FConvaiTrackedPropertyStateValueDesc>` | `[]`    | 为具有少量有意义状态（枚举、布尔值、命名阶段）的属性提供可选的逐值描述。对于自由变化的计数器或浮点数，无需填写。                                                    |
| `ShouldRespond`          | `EC_RunLLMOption`                              | `Never` | 此值在运行时发生变化时，聊天机器人应采取的操作。会话开始时的初始种子值始终为 `Never`.                                                             |

#### FConvaiTrackedPropertyStateValueDesc

中的单个值描述条目 `FConvaiTrackedProperty.StateValueDescriptions`。描述某个被跟踪属性的特定值所代表的含义。

| 字段            | 类型        | 说明                                                                        |
| ------------- | --------- | ------------------------------------------------------------------------- |
| `Value`       | `FString` | 发送给聊天机器人的字面值（例如 `"Locked"`, `"true"`, `"0"`, `"Idle"`）。必须与该属性在运行时读取到的值一致。 |
| `Description` | `FString` | 此值在人类语境中的含义——AI 看到此值时应理解的内容。                                              |

#### EConvaiAttentionSource

跟踪是谁设置了聊天机器人当前的 `CurrentAttentionObject`。只有当注意力来源为 `None` 或已经是 `Gaze`时，凝视驱动的注意力才能占用该位置。来自蓝图或 C++ 的 `Explicit` 设置优先，并会一直占用该位置，直到被清除。

| 值          | 显示名称               | 说明                                                  |
| ---------- | ------------------ | --------------------------------------------------- |
| `None`     | `None`             | 当前没有对象处于注意力焦点。                                      |
| `Explicit` | `Explicit（蓝图/C++）` | 通过蓝图或 C++ 调用 `SetObjectInAttention` 设置。凝视无法覆盖此设置。   |
| `Gaze`     | `Gaze`             | 由凝视注意力系统设置。可被 `Explicit` 覆盖；当玩家移开视线时，也可被 `None` 覆盖。 |

***

### 操作类型

这些类型定义了操作模板系统：如何向聊天机器人注册操作，以及如何在 `OnActionReceivedEvent_V2`.

#### 中接收填充后的结果

在 `FConvaiEnvironmentData.Actions`中注册的操作模板。定义 AI 可以执行哪些操作，以及如何向 LLM 描述每项操作。

| 字段                       | 类型                           | 默认值     | 说明                                                                            |
| ------------------------ | ---------------------------- | ------- | ----------------------------------------------------------------------------- |
| `Name`                   | `FString`                    | `""`    | 不带占位符的规范操作名称（例如 `"Move To"`, `"Parse"`, `"Open Door"`).                       |
| `Description`            | `FString`                    | `""`    | 操作功能的可选描述。提供给 LLM，以提高准确性。                                                     |
| `Parameters`             | `TArray<FConvaiActionParam>` | `[]`    | 有序的类型化参数。响应会按位置将填充值映射回这些名称。                                                   |
| `bWaitForBotSpeech`      | `bool`                       | `false` | 当 `true` 且此操作是序列中的第一个操作时，分发会延后，直到角色开始或结束说话后才触发该操作。对序列中的后续操作无影响。               |
| `DelayAfterBotSpeechSec` | `float`                      | `0.0`   | 在 `bWaitForBotSpeech` 完成后应用的额外延迟（秒）。当 `0` 为 `bWaitForBotSpeech` 时，视为 `false`. |

#### FConvaiActionParam

一个类型化占位符参数，属于 `FConvaiAction` 模板。

| 字段            | 类型                       | 默认值       | 说明                                                     |
| ------------- | ------------------------ | --------- | ------------------------------------------------------ |
| `Name`        | `FString`                | `""`      | 占位符在模板中显示的名称（例如 `"destination"`, `"time in seconds"`). |
| `Description` | `FString`                | `""`      | 参数含义的可选说明。提供给 LLM，以便更准确地选择值。                           |
| `Type`        | `EConvaiActionParamType` | `Auto`    | 声明的类型。决定提示信息以及解析器如何解读响应。                               |
| `Connector`   | `FString`                | `""`      | 可选的连接文本，在传输格式中渲染于此参数之前（例如 `"on"` ，用于“把球放在桌子上”）。        |
| `Choices`     | `TArray<FString>`        | `[]`      | 固定选项约束。非空时，LLM 会从此列表中选择。若 `Type` 为 `Enum`.             |
| `EnumType`    | `TObjectPtr<UEnum>`      | `nullptr` | 用于提取选项的蓝图枚举类型。当 `Type` 为 `Enum`.                       |

#### EConvaiActionParamType

操作参数的声明类型。决定 LLM 如何在传输格式中呈现该参数，以及解析器如何解读响应。

| 值           | 显示名称              | 说明                                                                                                |
| ----------- | ----------------- | ------------------------------------------------------------------------------------------------- |
| `Auto`      | `Auto`            | 在解析时推断：先尝试 `Reference` ，再尝试 `Number`，然后尝试 `Bool`，最后回退到 `String`。最灵活的选项。                           |
| `Reference` | `Actor Reference` | 该值根据 `Environment.Objects` 和 `Environment.Characters`解析。结果填入 `FConvaiResultParam.RefValue`.       |
| `String`    | `String`          | 自由格式文本值。结果存储在 `FConvaiResultParam.StringValue`.                                                   |
| `Number`    | `Number`          | 数值。结果存储在 `FConvaiResultParam.NumberValue`.                                                        |
| `Bool`      | `Bool`            | 布尔值（`"true"`, `"yes"`, `"1"` → `true`）。结果存储在 `FConvaiResultParam.BoolValue`.                      |
| `Enum`      | `Enum`            | 值受 `UEnum`限制。选项根据 `FConvaiActionParam.EnumType`自动推导。匹配的枚举项的字节值存储在 `FConvaiResultParam.ByteValue`. |

#### FConvaiResultAction

由 AI 解析并分发的操作，通过 `OnActionReceivedEvent_V2`传递。包含操作名称、原始操作字符串以及参数值的类型化映射。

{% hint style="warning" %}
`RelatedObjectOrCharacter` 和 `ConvaiExtraParams` 已弃用。请改为从 `Parameters` 映射中读取参数值。
{% endhint %}

| 字段                         | 类型                                  | 说明                                                                                       |
| -------------------------- | ----------------------------------- | ---------------------------------------------------------------------------------------- |
| `Action`                   | `FString`                           | 与模板匹配的规范操作名称。                                                                            |
| `ActionString`             | `FString`                           | AI 返回的完整渲染操作字符串，未经预处理。                                                                   |
| `Parameters`               | `TMap<FString, FConvaiResultParam>` | 按插入顺序排列的映射，将占位符名称映射到类型化值。键为 `FConvaiActionParam.Name`.                                   |
| `bWaitForBotSpeech`        | `bool`                              | 镜像自 `FConvaiAction.bWaitForBotSpeech`，在解析时复制。仅对新到达序列中的第一个操作生效。                           |
| `DelayAfterBotSpeechSec`   | `float`                             | 镜像自 `FConvaiAction.DelayAfterBotSpeechSec`。在以下情况下视为 `0` 当 `bWaitForBotSpeech` 为 `false`. |
| `RelatedObjectOrCharacter` | `FConvaiObjectEntry`                | **已弃用。** 与第一个 `Reference` 参数相同。请改用 `Parameters` 。                                        |
| `ConvaiExtraParams`        | `FConvaiExtraParams`                | **已弃用。** 镜像 `Parameters`中的数值、文本和字符串映射值。请改用 `Parameters` 。                                |

#### FConvaiResultParam

FConvaiResultAction.Parameters `中的单个类型化参数值`。无论声明的类型是什么，都会尽可能填充所有值字段——请读取适合你的处理程序的字段。

| 字段            | 类型                       | 说明                                                                                              |
| ------------- | ------------------------ | ----------------------------------------------------------------------------------------------- |
| `Type`        | `EConvaiActionParamType` | 来自操作模板的声明类型。指示预期使用哪个值字段。                                                                        |
| `StringValue` | `FString`                | 原始字符串值。始终会填充。                                                                                   |
| `NumberValue` | `float`                  | `atof(StringValue)`. `0` （如果不是数字）。始终会尝试转换。                                                      |
| `BoolValue`   | `bool`                   | `true` 当 `StringValue` 为 `"true"`, `"yes"`或 `"1"`时。始终会尝试转换。                                     |
| `RefValue`    | `FConvaiObjectEntry`     | 匹配的 `Actor` 条目（当 `StringValue` 在 `Environment.Objects` 或 `Environment.Characters`中解析时）。无匹配项时为空。 |
| `ByteValue`   | `uint8`                  | 匹配的枚举项的字节值，参数类型为 `Enum` 和 `EnumType` 时设置。使用 Byte-to-Enum 转换节点获取带类型的值。 `0` 用于非`Enum` 参数。         |

***

### 情绪类型

这些类型由以下方法使用： `ForceSetEmotion`, `GetEmotionScore`以及 `GetEmotionBlendshapes` （位于 `UConvaiChatbotComponent`.

#### EBasicEmotions

普鲁奇克情绪轮中的八种基本情绪。传递给 `ForceSetEmotion` 以覆盖角色的情绪状态。

| 值              | 蓝图显示名称     | 备注                     |
| -------------- | ---------- | ---------------------- |
| `Joy`          | `Happy`    |                        |
| `Trust`        | `Calm`     |                        |
| `Fear`         | `Afraid`   |                        |
| `Surprise`     | `Surprise` |                        |
| `Sadness`      | `Sad`      |                        |
| `Disgust`      | `Bored`    |                        |
| `Anger`        | `Angry`    |                        |
| `Anticipation` | —          | 标记为 `Hidden`。仅供内部使用。   |
| `None`         | —          | 标记为 `Hidden`。未找到情绪时返回。 |

#### EEmotionIntensity

使用 `ForceSetEmotion`.

| 值             | 显示名称           | 说明                                    |
| ------------- | -------------- | ------------------------------------- |
| `Basic`       | `Basic`        | 该情绪的标准强度。                             |
| `LessIntense` | `Less Intense` | 较温和的变体（例如 `Joy` → `宁静`, `愤怒` → `恼怒`). |
| `MoreIntense` | `更强烈`          | 增强版本（例如 `喜悦` → `狂喜`, `愤怒` → `暴怒`).    |
| `None`        | —              | Marked `BlueprintHidden`。无法确定强度时返回。   |

***

### 连接和会话类型

这些类型由连接状态查询和连接管理函数返回。

#### EC\_ConnectionState

聊天机器人组件与 Convai 之间 WebRTC 通道的当前状态。由 `GetChatbotConnectionState` （ `UConvaiChatbotComponent`.

| 值              | 显示名称           | 说明                    |
| -------------- | -------------- | --------------------- |
| `Disconnected` | `Disconnected` | 没有活动会话。               |
| `Connecting`   | `Connecting`   | 正在进行握手。               |
| `Connected`    | `Connected`    | 会话处于活动状态，已准备好接收音频和文本。 |
| `Reconnecting` | `Reconnecting` | 先前的会话已断开，插件正在重新建立连接。  |

#### EC\_PrepResult

的结果： `PrepareCharacterConnection` （ `UConvaiConnectionLibrary`）。指示预热请求是否已被接受，以及连接槽位处于何种状态。

| 值      | 显示名称   | 说明                                  |
| ------ | ------ | ----------------------------------- |
| `已接受`  | `已接受`  | 预热请求已被接受，正在准备连接槽位。                  |
| `已预热`  | `已预热`  | 此角色的连接槽位已处于活动或预热状态——无需进行其他操作。       |
| `已拒绝`  | `已拒绝`  | 连接管理器拒绝替换当前占用活动连接槽位的其他角色。           |
| `输入无效` | `输入无效` | 角色 ID 为空。                           |
| `已禁用`  | `已禁用`  | 已解析的预热连接 TTL `0.0` 或更低时，连接预热功能将被禁用。 |
| `内部错误` | `内部错误` | 由于子系统或管理器不可用，或连接尝试失败，无法完成请求。        |

#### EC\_RunLLMOption

控制 Convai 在环境更新调用（`SetContextState`, `AddContextEvent`, `SetObjectInAttention`等）。默认值因函数而异，请查看各函数的说明。

| 值        | 显示名称     | 说明                           |
| -------- | -------- | ---------------------------- |
| `Auto`   | `Auto`   | Convai 会根据更新的性质判断是否适合生成响应。   |
| `Always` | `Always` | 角色在此更新后始终会生成并说出响应。           |
| `Never`  | `Never`  | AI 会在不发言的情况下获知此更新，但不会主动谈及此事。 |

#### EC\_ContextUpdateMode

用于 `UpdateContext` 在 `UConvaiChatbotComponent` 上使用的模式，用于控制新文本与角色现有动态上下文的合并方式。

| 值         | 显示名称      | 说明                 |
| --------- | --------- | ------------------ |
| `Append`  | `Append`  | 将新文本追加到现有动态上下文的末尾。 |
| `Replace` | `Replace` | 用新文本替换匹配的上下文条目。    |
| `Reset`   | `Reset`   | 清除整个动态上下文，然后设置新文本。 |

***

### 音频类型

这些类型用于 VAD（语音活动检测）设置和长期记忆中的说话人识别。

#### FConvaiVADSettings

语音活动检测覆盖设置。通过 `SetVADSettings` 设置，并通过 `GetVADSettings` 在 `UConvaiUtils`上读取。当 `bUseServerDefault` 为 `true`时，所有其他字段都会被忽略，Convai 将应用自身的默认值。

| 字段                  | 类型      | 默认值    | 约束        | 说明                                                         |
| ------------------- | ------- | ------ | --------- | ---------------------------------------------------------- |
| `bUseServerDefault` | `bool`  | `true` | —         | 总开关。为 `true`时，以下所有字段值都会被忽略。                                |
| `Confidence`        | `float` | `0.7`  | `0.0–1.0` | VAD 模型判定某帧包含语音所需的最低概率。值越高，判定越严格。                           |
| `StartSecs`         | `float` | `0.2`  | `>= 0.0`  | 持续说话多少秒后触发 `"user started speaking"` 。值越高，越能忽略短暂的声音。       |
| `StopSecs`          | `float` | `2.2`  | `>= 0.0`  | 静音多少秒后触发 `"user stopped speaking"` 。值越低，轮次结束检测越快，但也可能截断语音。 |
| `MinVolume`         | `float` | `0.6`  | `0.0–1.0` | 振幅下限——低于此级别的音频会被视为静音。这是抑制背景噪声的主要调节项。                       |

#### FConvaiSpeakerInfo

用于长期记忆操作的说话人身份。在将会话记忆与特定最终用户关联时使用。

| 字段          | 类型        | 说明            |
| ----------- | --------- | ------------- |
| `SpeakerID` | `FString` | 说话人的唯一标识符。    |
| `Name`      | `FString` | 说话人的显示名称。     |
| `DeviceID`  | `FString` | 与说话人关联的设备标识符。 |

***

### 口型同步类型

#### EC\_LipSyncMode

由面部同步组件配置，并由口型同步辅助函数返回。

| 值                 | 显示名称             | 说明                      |
| ----------------- | ---------------- | ----------------------- |
| `Off`             | `Off`            | 口型同步已禁用。                |
| `Auto`            | `Auto`           | 插件根据配置的骨架选择输出模式。        |
| `VisemeBased`     | `基于音素`           | 面向音素驱动型骨架的音素输出。         |
| `BS_MHA`          | `MetaHuman 混合形状` | MetaHuman 和 CC5 混合形状输出。 |
| `BS_ARKit`        | `ARKit 混合形状`     | ARKit 混合形状输出。           |
| `BS_CC4_Extended` | `CC4 扩展混合形状`     | CC4 扩展混合形状输出。           |

***

### 混合形状类型

#### FConvaiBlendshapeParameters

用于为每个混合形状配置变换，由 `MapBlendshapes` 中的 [Convai 实用函数使用](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/blueprint-reference/convai-utility-functions.md).

| 字段                      | 类型              | 默认值     | 说明                                                   |
| ----------------------- | --------------- | ------- | ---------------------------------------------------- |
| `TargetNames`           | `TArray<FName>` | `[]`    | 用于写入变换后数值的输出键名称。                                     |
| `Multiplyer`            | `float`         | `1.0`   | 应用全局修饰符之前，为每个混合形状应用的乘数。                              |
| `Offset`                | `float`         | `0.0`   | 乘法之后为每个混合形状应用的偏移量。                                   |
| `UseOverrideValue`      | `bool`          | `false` | 当 `true`时，直接写入 `OverrideValue` ，忽略输入值和修饰符。           |
| `IgnoreGlobalModifiers` | `bool`          | `false` | 当 `true`, `时，忽略` 和 `对` 中的 `MapBlendshapes` 不会应用于此条目。 |
| `OverrideValue`         | `float`         | `0.0`   | 当 `UseOverrideValue` 为 `true`.                       |
| `ClampMinValue`         | `float`         | `0.0`   | 输出会限制在此最小值。                                          |
| `ClampMaxValue`         | `float`         | `1.0`   | 输出会限制在此最大值。                                          |

### 相关参考

{% content-ref url="/pages/4a6e5ee0afdb709983f0b5685e8cf00febcf5282" %}
[Convai 聊天机器人组件](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/blueprint-reference/convai-chatbot-component.md)
{% endcontent-ref %}

{% content-ref url="/pages/7882b4c0154c419a4eb6df2db3b2035b55cacb03" %}
[Convai 玩家组件](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/blueprint-reference/convai-player-component.md)
{% endcontent-ref %}

{% content-ref url="/pages/0d2b21389ed61f2a508324d6aaffcbf7a2e30487" %}
[Convai Object Component](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/blueprint-reference/convai-object-component.md)
{% endcontent-ref %}

{% content-ref url="/pages/54960e661fc090cc4ab31a059146f22c63a84ad3" %}
[Convai 工具函数](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/blueprint-reference/convai-utility-functions.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/blueprint-reference/data-types-and-enums.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
