> 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.md).

# Blueprint 参考

查找 Convai Unreal Engine 插件运行时工作流的已验证 Blueprint 组件、工具、音频和共享数据参考。

Blueprint 参考文档记录了 Convai Unreal Engine 插件的核心运行时 Blueprint 接口：聊天机器人、玩家和对象组件；共享结构体和枚举；麦克风采集；以及跨领域的工具库。当你需要精确的属性名称、函数签名、默认值、类别和约束时，请使用这些页面。

特定功能的 Blueprint 节点——动作参数访问器、动态上下文传输细节、情绪辅助工具、长期记忆（LTM）节点、视觉和叙事设计——都位于各自功能的 Blueprint 参考页面中。该 **Convai Subsystem** 连接接口记录于 [会话生命周期](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/core-concepts/session-lifecycle.md)，而不是这里。

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Convai Chatbot Component</strong><br>AI 角色组件的属性、函数和事件，包括会话、身份、口型同步、视觉和环境 API。</td><td><a href="/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/blueprint-reference/convai-chatbot-component.md">Convai 聊天机器人组件</a></td></tr><tr><td><strong>Convai 玩家组件</strong><br>玩家组件的属性、函数和事件，包括身份、会话、麦克风采集、流式传输和凝视注意力。</td><td><a href="/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/blueprint-reference/convai-player-component.md">Convai 玩家组件</a></td></tr><tr><td><strong>Convai 对象组件</strong><br>世界对象标记组件的属性、函数和事件，包括跟踪属性、移动感知和凝视回调。</td><td><a href="/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/blueprint-reference/convai-object-component.md">Convai Object Component</a></td></tr><tr><td><strong>麦克风和音频采集</strong><br>麦克风设备结构体、玩家组件采集函数、音频采集组件以及 Android 权限要求。</td><td><a href="/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/blueprint-reference/microphone-and-audio-capture.md">麦克风和音频捕获</a></td></tr><tr><td><strong>Convai 工具函数</strong><br>用于视线跟随辅助、组件查找、设置访问器、混合形状工具、文件 I/O 和连接预热的 Blueprint 库。</td><td><a href="/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/blueprint-reference/convai-utility-functions.md">Convai 工具函数</a></td></tr><tr><td><strong>数据类型和枚举</strong><br>跨组件使用的共享 Blueprint 结构体和枚举，包括对象条目、动作类型、连接状态和 VAD 设置。</td><td><a href="/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/blueprint-reference/data-types-and-enums.md">数据类型和枚举</a></td></tr></tbody></table>

### 功能 Blueprint 参考

请使用这些页面查看扩展核心组件 API 的特定功能节点：

| 功能      | 页面                                                                                                                                                  |
| ------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| 角色动作    | [动作 Blueprint 参考](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/character-actions/actions-blueprint-reference.md)          |
| 动态上下文   | [动态上下文 Blueprint 参考](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/dynamic-context/dynamic-context-blueprint-reference.md) |
| Emotion | [情绪 Blueprint 参考](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/emotion/emotion-blueprint-reference.md)                    |
| 长期记忆    | [LTM Blueprint 参考](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/long-term-memory/ltm-blueprint-reference.md)              |
| 叙事设计    | [叙事设计蓝图参考](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/narrative-design/narrative-design-blueprint-reference.md)         |
| 视觉      | [视觉 Blueprint 参考](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/vision/vision-blueprint-reference.md)                      |
| 凝视关注    | [凝视关注参考](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/gaze-attention/gaze-attention-reference.md)                         |
| 口型同步    | [面部同步组件参考](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/lip-sync/face-sync-component-reference.md)                        |


---

# 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.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.