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

# 插件与集成

- [Convai Unity SDK](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk.md): 为 Unity 训练模拟、交互式体验和游戏添加实时 AI 角色——支持语音、情绪、动作和持久记忆。
- [Convai Unity SDK 概览](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/overview.md): 了解 Convai Unity SDK 是什么、其四层架构如何组织，以及包中包含哪些功能模块。
- [什么是 Convai Unity SDK](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/overview/what-is-the-convai-unity-sdk.md): 面向 Unity 的实时对话式 AI 角色——语音管线、可选功能模块、支持的平台和最低要求。
- [Convai Unity SDK 架构](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/overview/convai-unity-sdk-architecture.md): 了解 Convai Unity SDK 的四层架构——运行时、房间、代理和模块——以及每一层的职责。
- [功能地图](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/overview/feature-map.md): 根据用例，查找适合你任何开发目标的 Convai Unity SDK 功能、模块、指南或参考页面。
- [发行说明](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/overview/release-notes.md): Convai Unity SDK 的发行说明——当前版本亮点、以前的发行说明、错误修复以及每个版本的迁移指南。
- [兼容性与要求](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/compatibility-and-requirements.md): 在安装 Convai Unity SDK 之前，了解你需要的 Unity 版本、渲染管线、平台和网络要求。
- [Unity 版本和渲染管线](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/compatibility-and-requirements/unity-versions-and-render-pipelines.md): Convai Unity SDK 环境要求参考，包括最低 Unity 版本、所需包依赖项和渲染管线支持。
- [平台支持矩阵](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/compatibility-and-requirements/platform-support-matrix.md): Convai Unity SDK 平台支持参考，包括 Windows、macOS、Android、iOS、Meta Quest 和 WebGL 的功能可用性。
- [网络和 API 要求](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/compatibility-and-requirements/network-and-api-requirements.md): 说明 Unity 项目在通过互联网连接到 Convai 之前必须允许哪些网络主机、端口和防火墙规则。
- [快速开始](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/getting-started.md): 从安装 Convai Unity SDK 到在场景中验证可用的对话式 AI 角色的分步路径。
- [前提条件](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/getting-started/prerequisites.md): 在开始安装前，确认 Convai Unity SDK 所需的 Unity 版本、包依赖项和 Convai 账户。
- [安装 Convai Unity SDK](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/getting-started/installation.md): 使用 Package Manager 或 Asset Store 将 Convai Unity SDK 安装到 Unity 项目中，以便 SDK 及其依赖项正确解析。
- [配置 API 密钥](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/getting-started/configure-api-key.md): 在 Unity 编辑器中输入并验证用于本地开发的 Convai API 密钥，这样 Convai 角色就能在你构建场景时进行身份验证。
- [导入并运行示例场景](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/getting-started/import-and-run-sample-scenes.md): 导入捆绑的示例场景，并在构建自己的场景之前验证 SDK 是否已正确安装并连接。
- [场景组件参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/getting-started/scene-components.md): 了解每个核心 Convai 场景组件——管理器、房间管理器、角色和玩家——的作用，以及它们彼此之间的依赖关系。
- [构建自定义场景](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/getting-started/build-a-custom-scene.md): 使用“设置所需组件”命令向新的 Unity 场景添加所需的 Convai 组件，并配置你的第一个角色。
- [验证你的设置](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/getting-started/validate-your-setup.md): 使用 Troubleshooter 窗口检查 Convai 角色，并在进入播放模式之前确认所需组件已存在。
- [配置对话输入模式](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/getting-started/configure-conversation-input-mode.md): 在免提语音激活和按键通话之间进行选择，配置触发键或手柄按钮，并在运行时在两种模式之间切换。
- [配置角色音频](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/getting-started/configure-character-audio.md): 配置单个角色和项目级的语音音量、空间音频和音频反馈，并通过静音与取消静音调用在脚本中控制播放。
- [配置麦克风](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/getting-started/configure-microphone.md): 在运行时选择一个活动麦克风设备，设置全项目默认值，并为 Android、iOS 和 WebGL 构建配置平台权限。
- [添加聊天 UI](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/getting-started/add-chat-ui.md): 添加随附的聊天文字记录预制体，以便在角色交互期间在屏幕上显示可滚动的对话历史。
- [添加口型同步](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/getting-started/add-lip-sync.md): 将 Convai 音频输出连接到角色的面部 BlendShape，同步口部动作与语音，并调整播放延迟。
- [配置文件与映射](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/getting-started/add-lip-sync/profiles-and-mappings.md): 控制 Convai blendshape 数据如何传递到角色面部网格的配置文件和映射资产的参考，以及何时创建自定义资产。
- [创建口型同步配置文件](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/getting-started/add-lip-sync/create-a-lip-sync-profile.md): 说明如何为超出 SDK 默认捆绑的三个配置文件之外的 BlendShape 格式创建自定义口型同步配置文件资源。
- [创建自定义口型同步映射](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/getting-started/add-lip-sync/create-a-custom-blendshape-map.md): 创建一个口型同步映射，将传入的 BlendShape 通道路由到角色的网格，并可按通道调整权重和钳制参数。
- [身份验证](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/authentication.md): 比较 Convai Unity SDK 的 API Key 和 Auth Token 身份验证模式，了解何时使用各自模式，以及玩家构建中包含什么。
- [身份验证如何运作](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/authentication/how-authentication-works.md): 了解 Convai Unity SDK 遵循的凭证解析顺序，以及每种身份验证模式发送的传输头。
- [配置 Auth Token 模式](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/authentication/configure-auth-token-mode.md): 将 Convai Unity SDK 项目切换到 Auth Token 模式，并在项目设置中为已发布构建配置令牌端点。
- [编写自定义令牌提供程序](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/authentication/custom-token-provider.md): 注册一个自定义凭证提供程序，让你的后端为每次连接自动签发短期 Convai 身份验证令牌。
- [使用现有身份验证令牌连接](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/authentication/connect-with-auth-token.md): 当你的登录层已经持有一个已签发的 Convai 身份验证令牌时，直接将其传入单次连接调用。
- [身份验证脚本参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/authentication/scripting-reference.md): Convai Unity SDK 身份验证 API 的参考，包括令牌提供程序接口、注册表和设置访问器。
- [发布安全构建](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/authentication/ship-a-secure-build.md): 以 Auth Token 模式构建 Convai Unity SDK 玩家，使账户 API Key 永远不会进入已发布构建，并满足 WebGL 的 CORS 要求。
- [身份验证故障排查](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/authentication/troubleshooting.md): 根据准确的控制台消息、错误代码，以及 API Key 和 Auth Token 模式的成因，修复 Convai Unity SDK 身份验证失败。
- [AI 编码助手](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/ai-coding-assistant.md): 查找将 AI 编码代理通过 Convai 的 SDK 感知 MCP 工具连接到 Unity 的指南，包括设置、受支持的代理和故障排除。
- [AI 编码助手快速入门](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/ai-coding-assistant/quick-start.md): 打开 Convai 编辑器中的 AI 编码部分，接受 Unity MCP 条款，安装编码代理的指令，并验证 Convai 的工具。
- [受支持的编码代理](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/ai-coding-assistant/supported-coding-agents.md): Convai Unity SDK 支持的编码代理参考，包括每个代理的确切指令文件路径和安装行为。
- [MCP 工具参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/ai-coding-assistant/mcp-tools-reference.md): 面向编码代理公开的每个 Convai MCP 工具的参考，包括默认启用状态和场景修改行为。
- [排查 AI 编码助手设置问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/ai-coding-assistant/troubleshooting.md): 诊断并修复 Unity MCP 桥重新连接、工具注册表刷新、过期工具拒绝，以及 Convai Unity SDK 中 Unity AI Assistant 的安装失败。
- [核心概念](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/core-concepts.md): 了解 Convai Unity SDK 在运行时如何工作——连接、会话、具身化、对话状态以及事件驱动响应。
- [运行时架构](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/core-concepts/runtime-architecture.md): 了解分层的 Convai Unity SDK 运行时——每一层负责什么、单个角色的具身层，以及运行时生命周期状态如何管理。
- [会话生命周期](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/core-concepts/session-lifecycle.md): 说明角色连接如何在不同状态之间移动、如何在重新连接后保持会话，以及如何暂停、恢复或进入后台。
- [角色具身化](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/core-concepts/character-embodiment.md): 了解角色的具身化模块如何共享一个组合根、以确定性方式逐帧执行，并且不会对同一根骨骼写入两次。
- [对话状态](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/core-concepts/dialogue-state.md): 了解具身化模块读取的八值对话状态，以判断角色是空闲、聆听还是说话中。
- [资产所有权与写时复制](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/core-concepts/asset-ownership.md): 了解为什么编辑包随附的 Convai 配置文件会创建一个可编辑的项目副本，而不是更改原始资产。
- [轮流发言模式](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/core-concepts/turn-taking-modes.md): 配置免提和按键通话对话模式，包括轮次检测、松开时机以及抢话打断行为。
- [语音活动检测](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/core-concepts/voice-activity-detection.md): 了解 Convai Unity SDK 如何在连接时仅执行一次用户语音活动检测设置解析，使用 Convai 默认值或你的自定义值。
- [事件系统](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/core-concepts/event-system.md): Convai 事件中继组件参考，包括可用事件、载荷字段以及用于场景逻辑的订阅模式。
- [具身化](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment.md): 查找为 Convai 角色提供眼神接触、手势、姿势和表情的模块，并了解应先添加哪一个。
- [具身化如何运作](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/how-embodiment-works.md): 了解 Convai 如何在运行时构建每个角色的具身化基础设施，以及模块每帧运行的固定顺序。
- [具身化快速入门](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/quick-start.md): 将凝视模块添加到现有 Convai 角色，使其与玩家进行眼神接触，并在 Play 模式下立即可见。
- [角色骨架设置](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/character-rig-setup.md): 配置角色骨架，使 Convai 自动检测其面部 blendshape 规范和骨骼，并解决低置信度检测。
- [具身化预设](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/embodiment-presets.md): 将多个具身化模块的配置文件打包为一个可复用预设，并应用到角色上，使每个模块的设置一起随之移动。
- [面部组合](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/facial-composition.md): 面部组合配置文件参考，包括按区域的 blend 配置、blend 模式和层级优先级。
- [具身化编辑器窗口](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/embodiment-editor.md): Convai 具身化编辑器窗口参考，涵盖“设置”“预设”和“实时”选项卡，以及每个选项卡展示的角色信息。
- [具身化脚本参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/scripting-reference.md): Convai 具身化脚本接口参考，包括角色上下文、模块基类、骨架绑定和共享枚举。
- [排查具身化问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/troubleshooting.md): 诊断 Convai 具身化系统中的骨骼检测、预设槽位、模块 Tick 和面部合成问题，并提供修复与验证步骤。
- [对话流程](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/conversation-flow.md): 了解 Conversation Flow 模块在对话中跟踪什么，以及为什么其他每个具身化模块都依赖它的时序。
- [配置对话流程](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/conversation-flow/configure.md): 将 Conversation Flow 模块添加到角色，或让 Convai 自动创建它，然后分配一个配置文件来调整其时序。
- [对话流程参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/conversation-flow/reference.md): Conversation Flow 控制器公共 API、其返回的对话状态读取值，以及配置文件资源上每个时序字段的完整参考。
- [排查对话流程问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/conversation-flow/troubleshooting.md): 诊断停留在 Idle 的对话状态、感觉不对的时序，以及多角色场景中对话流程驱动器之间的冲突。
- [视线](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/gaze.md): 查找使用 Gaze 具身化模块为 Convai 角色添加眼神接触、注意力转移和全身转向的指南。
- [视线工作原理](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/gaze/how-gaze-works.md): 了解 Gaze 模块如何选择目标、在眼睛、头部和身体之间共享注视，并对对话的状态作出反应。
- [Gaze 快速开始](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/gaze/quick-start.md): 将 Gaze 模块添加到现有 Convai 角色，并确认它在 Play 模式下立即与玩家进行眼神接触。
- [配置眼神接触](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/gaze/configure-eye-contact.md): 配置 Convai 角色对玩家眼神接触的投入强度，从自然行为到永久锁定。
- [视线目标与提供器](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/gaze/targets-and-providers.md): 将场景对象标记为视线候选项，添加高级提供器组件，并从代码中注册自定义视线目标提供器。
- [脚本控制的视线](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/gaze/scripted-gaze.md): 从代码中将 Convai 角色的视线指向某个 Transform 或点，并等待结果，以便在命中后再触发后续动作。
- [Gaze 配置文件参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/gaze/profile-reference.md): Convai Gaze 配置文件资源中每个设置组和字段的参考，包括每项的默认值和取值范围。
- [Gaze 脚本参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/gaze/scripting-reference.md): Convai Gaze 系统公共 API 的参考，包括控制器、Gaze 读取值、句柄以及目标提供器接口。
- [Gaze 使用示例](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/gaze/usage-examples.md): 通过四个完整的 Convai Gaze 使用示例，配置眼神接触、脚本化瞥视，并协调多角色视线。
- [排查视线问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/gaze/troubleshooting.md): 修复 Convai Gaze 角色中静止的眼睛、不会转动的头部、未选中的视线目标以及被拒绝的脚本视线。
- [身体动画](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-animation.md): 查找使用代码驱动的 Body Animation 模块为 Convai 角色添加待机、说话动作、行走和手势的指南。
- [身体动画工作原理](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-animation/how-body-animation-works.md): 了解分层动画图如何播放待机、说话、移动、动作和指向动画，以及对话状态如何驱动它。
- [身体动画快速入门](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-animation/quick-start.md): 将身体动画模块和随附的动画集添加到 Convai 角色，并在 Play 模式下看到空闲和说话动作。
- [构建动画集](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-animation/build-an-animation-set.md): 通过“创建动画集”向导，或逐字段编写条目，从一个动画片段文件夹中组装你自己的动画集。
- [配置移动](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-animation/configure-locomotion.md): 使用 Unity 烘焙的导航网格为 Convai 角色添加行走和慢跑移动，并提供可调速度和手动移动选项。
- [播放动作和手势](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-animation/play-actions-and-gestures.md): 从脚本中让 Convai 角色播放命名动作、锚定动作和指向手势，并读取每次调用返回的句柄。
- [身体动画配置参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-animation/config-reference.md): Convai Body Animation 配置资源中每个设置组和字段的参考，包括每项的默认值和取值范围。
- [身体动画脚本参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-animation/scripting-reference.md): Convai 身体动画公共 API 的参考，包括控制器、动作与指向句柄，以及移动类型。
- [身体动画使用示例](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-animation/usage-examples.md): 编写一个角色脚本，使其走向目标并在到达时打招呼、按提示做手势、指向场景对象，并报告自定义行进信息。
- [身体动画故障排查](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-animation/troubleshooting.md): 诊断无动作、T 姿势、移动不同步、与 Animator Controller 冲突、动作从不触发以及指向手势偏移的问题。
- [肢体语言](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-language.md): 查找添加环境性姿态、呼吸、重心转移和小型响应动作的指南，让 Convai 角色在动画间隙保持生动。
- [肢体语言如何运作](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-language/how-body-language-works.md): 了解 Body Language 如何在每个 tick 驱动 Convai 角色的姿态、呼吸和手势，以及它如何让位于脚本手势。
- [肢体语言快速入门](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-language/quick-start.md): 将 Body Language 组件添加到 Convai 角色，并在 Play 模式下看到呼吸、重心转移和空闲生命感。
- [调节表现力](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-language/tune-expressiveness.md): 使用表现力预设、运行时覆盖和按行为增益，让 Convai 角色的肢体语言看起来更含蓄或更戏剧化。
- [触发手势与反应](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-language/gestures-and-reactions.md): 在 Convai 角色上触发脚本化的点头、语义手势提示和一次性反应，并处理被拒绝或忙碌的请求。
- [肢体语言配置文件参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-language/profile-reference.md): Convai 角色肢体语言配置文件资产上的每个字段，按部分分组，并附带默认值和数值范围。
- [肢体语言脚本参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-language/scripting-reference.md): Convai 肢体语言模块的完整 API 参考，涵盖控制器、读取结构体、句柄以及所有公共枚举类型。
- [肢体语言故障排查](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-language/troubleshooting.md): 诊断为什么 Convai 角色的肢体语言控制器没有动作、与其他模块冲突，或者表现得过于含蓄或过于戏剧化。
- [情绪](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/emotion.md): 查找 Convai 角色面部表情与心情的指南，从初始设置到脚本 API 和故障排查。
- [情绪系统的工作原理](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/emotion/how-the-emotion-system-works.md): 了解 Emotion 如何解析 Convai 响应中的情绪信号，对其进行平滑处理，并组合角色的面部与情绪。
- [情绪快速入门](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/emotion/quick-start.md): 将 Convai Emotion 组件添加到角色，运行其设置检查清单，并在 Play 模式下看到面部对对话作出反应。
- [心情](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/emotion/moods.md): 通过代码设置和清除 Convai 角色的常驻心情，并了解心情与短暂的情绪反应有何不同。
- [Emotion 配置文件](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/emotion/emotion-profile.md): 角色情绪配置文件上的每个设置，涵盖静态情绪、漂移、感染、混合，以及让面部保持“活着”的微表情生命周期。
- [Emotion 输出绑定](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/emotion/output-bindings.md): Emotion 模块着色器属性输出绑定的参考，用于驱动脸红、泪光或汗光等效果。
- [Emotion 分类体系](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/emotion/emotion-taxonomy.md): 说明内置情绪集合、服务器标签如何映射到它，以及如何为角色编写自定义情绪分类体系。
- [Emotion 脚本 API](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/emotion/scripting-api.md): 说明如何从脚本中读取角色的情绪状态、控制情绪、锁定或覆盖表情，以及订阅情绪事件。
- [情绪编辑器窗口](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/emotion/emotion-editor.md): 情绪编辑器窗口参考，涵盖其四个选项卡以及从“实时”选项卡打开的情绪时间线记录器。
- [情绪示例](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/emotion/usage-examples.md): 七个完整场景，涵盖危险覆盖、锁定表情、心情转换、痛苦分支、分析日志以及无代码 UI 连接。
- [排查情绪问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/emotion/troubleshooting-and-diagnostics.md): 修复 Unity SDK 中常见的情绪管线问题，从完全没有面部输出到静默回退和口型同步冲突。
- [功能](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features.md): Convai Unity SDK 功能模块索引：动作、动态上下文、长期记忆、多角色会话、叙事设计、场景元数据、视觉。
- [角色动作](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/character-actions.md): 查找 Convai 角色动作在 Unity 中的 Actions Editor、执行器参考、调度器配置、脚本 API 和使用指南。
- [角色动作的工作原理](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/character-actions/how-character-actions-work.md): 了解 Convai 角色动作管线——Convai 如何选择动作、Unity 如何解析目标，以及需要哪些组件。
- [角色动作快速入门](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/character-actions/quick-start.md): 无需脚本，从 Actions Editor 的入门目录中为 Convai 角色添加一个现成动作，并确认其在 Play 模式下运行。
- [动作编辑器](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/character-actions/actions-editor.md): Convai Actions Editor 窗口参考——其四种模式、添加动作目录以及一键执行器配置。
- [配置角色动作](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/character-actions/configuring-actions.md): 配置 Convai NPC 可以使用哪些动作、对象和角色，然后在活动会话期间更新这些可供性。
- [在运行时更新角色动作](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/character-actions/update-actions-at-runtime.md): 在会话进行中发送一个动作配置补丁，跟踪其更新 ID，并在确认后端已确认之前不要假定更改已生效。
- [动作执行器](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/character-actions/action-executors.md): 按包分组的全部 21 个内置动作执行器组件参考，包括每个 Inspector 字段、默认值和所需的配套组件。
- [编写自定义动作执行器](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/character-actions/writing-custom-executors.md): 通过编写自己的执行器组件，将自定义移动、库存、UI 或物理行为连接到 Convai 动作管道。
- [分发器和批处理策略](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/character-actions/dispatcher-and-batch-policies.md): 配置分发器的批处理策略、失败策略、语音门控超时、插话和生命周期事件，以用于角色动作执行。
- [动作目标解析的工作方式](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/character-actions/attention-and-reference-grounding.md): 了解口头引用如何解析为特定的场景对象或角色，从 Convai 的语言匹配到 Unity 的本地查找。
- [角色动作脚本参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/character-actions/actions-scripting-reference.md): Convai 角色动作系统的 API 参考——执行器基类、调度器、配置类型、调用对象和枚举。
- [角色动作示例](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/character-actions/usage-examples.md): Convai 角色动作系统的渐进式示例——Inspector 设置、事件订阅、脚本化批量注入以及观察动作。
- [排查角色动作问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/character-actions/debugging-and-troubleshooting.md): 使用 Convai Troubleshooter、Action Monitor 和症状-修复参考，诊断角色动作设置与运行时问题。
- [动态上下文](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/dynamic-context.md): 查找通过动态上下文中继、脚本 API 和同步世界对象属性向 Convai 角色发送实时场景状态的指南。
- [动态上下文的工作原理](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/dynamic-context/how-dynamic-context-works.md): 了解 Dynamic Context 如何跟踪场景状态与事件、批量更新，以及报告确认和 token 反馈。
- [动态上下文快速开始](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/dynamic-context/dynamic-context-quick-start.md): 向 NPC 添加 Dynamic Context Relay 组件，从 UI 按钮发送一次被跟踪的更新，并确认角色引用了它。
- [中继组件参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/dynamic-context/relay-component-reference.md): 动态上下文中继组件的参考，涵盖其 Inspector 字段、公共方法、事件和角色解析行为。
- [连接时的静态上下文](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/dynamic-context/static-context-at-connection-time.md): 配置角色在对话开始时接收一次的固定场景事实，与对话运行期间发送的更新分开。
- [同步行为与时序](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/dynamic-context/sync-behavior-and-timing.md): 了解 SDK 如何在发送动态上下文更新前对其进行批处理，以及 Convai 如何确认动作和注意力变化。
- [动态上下文脚本 API](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/dynamic-context/dynamic-context-scripting-api.md): Convai Unity SDK 动态上下文脚本接口参考，包括每个方法、respond mode 枚举和 attention 对象 API。
- [动态上下文使用示例](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/dynamic-context/dynamic-context-usage-examples.md): 五个动态上下文示例展示了基于中继的触发、批量更新、事件日志、紧急切换以及同步的世界对象上下文。
- [排查动态上下文问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/dynamic-context/troubleshoot-dynamic-context.md): 修复 Convai Unity SDK 中常见的动态上下文问题，包括更新丢失、响应延迟，以及重置行为未清除所有内容。
- [长期记忆](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/long-term-memory.md): 查找所有长期记忆指南——为角色启用记忆、管理用户身份、使用记忆 API，并访问脚本参考。
- [长期记忆的工作原理](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/long-term-memory/how-long-term-memory-works.md): 了解长期记忆的会话生命周期、记忆如何按用户和角色作用域划分，以及事实如何被提取、去重和注入。
- [长期记忆快速开始](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/long-term-memory/quick-start.md): 三步为 Convai 角色启用长期记忆，并验证在 Unity Editor 中跨独立会话的回忆仍然有效。
- [为角色配置记忆](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/long-term-memory/configure-memory-for-a-character.md): 说明如何从仪表板或脚本中为角色开启或关闭长期记忆，以及其全局作用域对共享角色意味着什么。
- [终端用户身份](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/long-term-memory/end-user-identity.md): 了解 SDK 如何识别用于长期记忆作用域的用户，以及如何实现基于自定义认证的身份提供器。
- [管理终端用户记录](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/long-term-memory/end-user-management.md): 从 Convai Editor 窗口或脚本中浏览并管理终端用户记录，涵盖编辑器工具、所有方法和分页。
- [记忆管理 API](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/long-term-memory/memory-management-api.md): 为单个玩家列出、添加、检索和删除角色的记忆记录，包含设置、每个方法、响应类型和错误处理。
- [长期记忆脚本参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/long-term-memory/long-term-memory-scripting-reference.md): 完整的记忆与终端用户 API 参考：方法签名、参数、返回类型、身份接口以及各自返回的数据模型。
- [长期记忆使用示例](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/long-term-memory/usage-examples.md): Unity 中四个完整的长期记忆模式——零配置持久化、认证身份、记忆初始化和记忆重置。
- [排查长期记忆问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/long-term-memory/troubleshooting-and-diagnostics.md): 诊断长期记忆为什么没有持久化，验证终端用户身份在会话间是否稳定，并解决 Memory Management API 的 HTTP 错误。
- [多角色会话](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/multi-character-sessions.md): 查找在一个 Unity 场景中运行多个 Convai 角色、选择玩家与谁交谈以及测试共享房间的指南。
- [多角色会话工作原理](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/multi-character-sessions/how-multi-character-sessions-work.md): 了解包含多个 Convai 角色的 Unity 场景如何变成一个共享房间，以及房间如何决定玩家正在对谁说话。
- [构建你的第一个多角色会话](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/multi-character-sessions/quick-start.md): 向一个可用的 Unity 场景中添加第二个 Convai 角色，并确认房间允许你通过看向他们中的任意一个来与其对话。
- [角色身份](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/multi-character-sessions/character-identity.md): 为共享同一 Convai 房间的角色分配 Character ID 的参考，以及检测两个角色使用同一 ID 的检查机制。
- [多角色示例](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/multi-character-sessions/multi-character-sample.md): 导入多角色示例场景，查看多个 Convai 角色共享同一房间、交互目标选择以及实时文字记录。
- [房间就绪状态](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/multi-character-sessions/readiness-and-partial-dispatch.md): 了解共享 Unity 房间何时准备好接受玩家输入、为什么一个慢角色不会阻塞其他角色，以及如何报告启动失败。
- [角色加入与离开](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/multi-character-sessions/update-the-roster.md): 了解 Convai 角色如何自动加入或离开已连接的 Unity 房间，以及何时应改为从代码中编辑成员列表。
- [加入现有房间](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/multi-character-sessions/join-an-existing-session.md): 使用恰好一个房间定位器，将另一位人类参与者带入另一个客户端已创建的 Unity 多角色房间。
- [路由角色音频](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/multi-character-sessions/route-character-audio.md): 控制共享房间麦克风，按身份绑定和静音每个角色的音频，并在 Unity 中测量角色播放情况。
- [处理房间事件](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/multi-character-sessions/handle-roster-events.md): 订阅共享 Unity 房间中的成员列表和交互目标事件，并依赖 SDK 保证的它们之间的顺序。
- [房间会话参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/multi-character-sessions/room-session-reference.md): 多角色房间会话类型、其成员与状态字段，以及其命令返回的结果和异常的参考。
- [连接 API 参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/multi-character-sessions/connection-api-reference.md): 多角色连接操作、其加入与连接选项类型，以及每个操作可能抛出的所有异常的参考。
- [多角色使用示例](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/multi-character-sessions/usage-examples.md): 实现“看向地址”目标定位和脚本化成员列表切换，让 Unity 场景管理玩家正在对房间中哪个角色发话。
- [排查多角色会话问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/multi-character-sessions/troubleshooting.md): 在 Unity 中运行多角色会话时，修复成员列表拒绝、就绪失败、音频路由错误和命令错误。
- [对话目标选择](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/conversation-targeting.md): 查找用于选择目标模式、调优模式，以及在 Convai Unity SDK 房间中编写脚本指定玩家正在对哪个角色说话的指南。
- [对话目标选择如何运作](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/conversation-targeting/how-conversation-targeting-works.md): 了解 Convai Unity SDK 如何根据视线方向评分来决定玩家正在与谁对话，以及为什么在切换之间该决定保持稳定。
- [选择目标模式](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/conversation-targeting/choose-a-targeting-mode.md): 选择与相机和控制方案匹配的对话目标选择模式，以便正确的角色响应玩家。
- [调整对话目标选择](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/conversation-targeting/tune-targeting.md): 调整范围、视角、切换余量和切换延迟，使对话目标选择与角色之间的距离相匹配。
- [编写对话目标脚本](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/conversation-targeting/script-the-conversation-target.md): 通过脚本将对话转移到特定角色，并选择房间连接时打开在哪个角色上。
- [编写自定义目标选择规则](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/conversation-targeting/custom-targeting-rule.md): 当内置模式都不适合你的游戏如何选择对话对象时，用你自己的规则替换对话目标选择。
- [对话目标选择参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/conversation-targeting/targeting-reference.md): 控制 Convai Unity SDK 如何选择玩家正在与哪个角色对话的每个字段、默认值和事件的参考。
- [对话目标选择故障排查](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/conversation-targeting/troubleshooting.md): 修复在 Convai 多角色房间中无法切换、在角色之间闪烁或始终不移动的对话目标。
- [对话可用性](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/conversation-availability.md): 查找用于检查某个 Convai 角色当前是否能听到玩家，以及在不能时如何在 UI 中响应的指南。
- [对话可用性如何运作](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/conversation-availability/how-availability-works.md): 了解 Convai Unity SDK 如何判断某个角色是否能听到玩家，以及为什么仅仅连接到房间还不够。
- [根据可用性控制 UI](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/conversation-availability/gate-your-ui.md): 根据对话可用性控制自定义聊天输入框或麦克风按钮，使玩家输入要等到角色能听到时才生效。
- [自定义聊天输入框提示](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/conversation-availability/customise-chat-prompts.md): 更改随附聊天输入框在每种对话可用状态下显示的所有提示字符串，包括角色名称。
- [响应玩家开始说话](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/conversation-availability/local-player-activity.md): 在服务通过网络连接确认之前，先在本地响应玩家开始说话或按下按键通话。
- [对话可用性参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/conversation-availability/availability-reference.md): 用于控制 Convai Unity SDK 中玩家输入的对话可用状态、事件和方法的参考。
- [玩家输入故障排查](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/conversation-availability/troubleshooting.md): 修复 Convai Unity SDK 对话中的被拒绝消息、永久禁用的聊天输入框，或始终无法打开的麦克风。
- [叙事设计](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/narrative-design.md): 查找在 Convai Unity SDK 中设置、配置、脚本编写和排查 Narrative Design 系统的指南。
- [叙事设计的工作原理](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/narrative-design/how-narrative-design-works.md): 了解 Narrative Design 管线——各部分、触发器和模板键在运行时如何连接以推进故事图。
- [叙事设计快速开始](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/narrative-design/quick-start.md): 向 Convai 角色添加 Narrative Design Manager 和碰撞触发器，并在播放模式下确认章节切换——无需代码。
- [配置叙事设计管理器](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/narrative-design/setting-up-the-narrative-design-manager.md): 说明如何将叙事设计管理器添加到角色、从 Convai 同步其故事章节，并在 Inspector 中连接每章节事件。
- [配置叙事设计触发器](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/narrative-design/setting-up-narrative-design-triggers.md): 说明如何添加一个叙事设计触发器，通过碰撞、接近、计时或手动信号推进角色的故事。
- [配置叙事模板键](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/narrative-design/template-keys-dynamic-narrative-variables.md): 设置叙事模板键，使 Convai 角色能够在其目标中引用运行时值——玩家姓名、场景参数或会话状态。
- [叙事设计脚本参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/narrative-design/scripting-narrative-design.md): 从代码控制角色叙事流程的参考，涵盖区段事件、触发器调用、脚本化语音和数据获取。
- [叙事设计使用示例](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/narrative-design/usage-examples.md): 四个完整的 Narrative Design 示例，从单触发欢迎序列到带动态反馈的自适应多区段场景。
- [排查叙事设计问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/narrative-design/troubleshooting-and-diagnostics.md): 使用内置验证与诊断工具，解决触发器状态失败、Inspector 配置错误、获取错误和队列超时问题。
- [场景元数据](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/scene-metadata.md): 查找场景元数据的指南、组件参考和示例——该功能让 Convai 角色感知 Unity 场景中的对象。
- [场景元数据的工作原理](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/scene-metadata/how-scene-metadata-works.md): 了解场景对象元数据的注册与传递流程，并学习何时使用场景元数据而不是动态上下文。
- [场景元数据快速开始](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/scene-metadata/quick-start.md): 为 Unity 场景添加对象感知能力，使 Convai 角色在连接后即可在对话中引用命名对象。
- [场景元数据组件参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/scene-metadata/component-reference.md): 用于向 Convai 描述场景对象并暴露其实时跟踪状态的两个组件的参考，包括 Inspector 字段和生命周期。
- [场景元数据脚本 API](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/scene-metadata/scripting-api-reference.md): 场景元数据类的完整 C# 参考，涵盖对象属性、跟踪属性更新、注册表查询和手动发送触发器。
- [场景元数据使用示例](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/scene-metadata/usage-examples.md): 用于医疗培训、工业演练、博物馆导览、运行时对象更新和跟踪属性状态的完整场景元数据设置。
- [排查场景元数据问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/scene-metadata/troubleshooting-and-diagnostics.md): 修复场景元数据问题，包括空载荷、缺少集合日志、依赖注入失败以及 AI 角色忽略场景对象。
- [视觉](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/vision.md): 查找在 Unity 中为 Convai 角色添加实时场景视觉的指南，包括帧源、发布策略、脚本编写和故障排查。
- [视觉的工作原理](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/vision/how-vision-works.md): 了解 Vision 管线架构，包括帧来源、发布策略、到 Convai 的 WebRTC 轨道，以及动态视觉上下文如何融入其中。
- [动态视觉上下文](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/vision/dynamic-vision-context.md): 用于配置后端驱动的摄像机帧采样以及按通道响应模式默认值的动态视觉上下文类型参考。
- [视觉快速开始](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/vision/quick-start.md): 将 Vision 添加到现有 Convai 场景，使角色能够看到并响应实时摄像头输入，使用 SDK 的自动组件设置。
- [视觉帧源](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/vision/frame-sources.md): 说明为角色捕获可见视频的帧来源，涵盖场景相机、网络摄像头和 Meta Quest 透视画面。
- [发布策略](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/vision/publishing-and-policies.md): Vision 发布策略参考，包括 FPS 和码率预算、运行时控制方法、自动发布行为以及 WebGL 特定行为。
- [视觉调试预览](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/vision/debug-preview.md): 使用 Unity Editor 调试工具验证视觉摄像机画面，并确认视觉状态请求和触发器已到达 Convai。
- [自定义帧来源](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/vision/custom-frame-sources.md): 实现 IVisionFrameSource，将自定义视频管线发布到 Convai，包括 Y 翻转要求、生命周期状态模式和自动发现规则。
- [Vision 脚本 API](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/vision/scripting-api.md): Convai Unity SDK Vision 脚本 API 参考，包括发布控制、运行时状态查询、按需触发以及 respond-mode 事件。
- [视觉使用示例](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/vision/usage-examples.md): 查找常见视觉设置的代码模式，包括安全培训、摄像头选择、注视激活、按需触发和 WebGL 部署。
- [排查视觉问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/vision/troubleshooting-and-diagnostics.md): 使用结构化检查清单和决策树，在 Unity 中修复视觉发布失败、空白画面、权限错误和平台特定问题。
- [UI 与呈现](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/ui-and-presentation.md): 可选的场景级 UI，用于显示转录、提示通知以及为用户提供运行时设置面板——仅添加项目所需的内容。
- [转录 UI](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/ui-and-presentation/transcript-ui.md): 了解 Convai Unity SDK 如何将持久聊天历史与与语音对齐的字幕分开，以及哪个内置组件显示哪一类内容。
- [转录历史与查询](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/ui-and-presentation/transcript-ui/transcript-history-and-queries.md): 从代码读取当前对话轮次时间线，实时响应轮次变化，并将会话历史导出为文本、Markdown 或 JSON。
- [聊天和字幕模式](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/ui-and-presentation/transcript-ui/chat-and-subtitle-modes.md): 向场景中添加可滚动的聊天历史、实时字幕或两者，并配置每种转录显示的外观和行为。
- [通知系统](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/ui-and-presentation/notification-system.md): 添加吐司式提示以自动显示会话错误，并使用通知资源从代码中触发你自己的场景内警报。
- [通知系统参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/ui-and-presentation/notification-system/notification-system-reference.md): SONotification、SONotificationGroup、UINotificationController 和 SONotificationErrorMap 的参考——字段、方法和配置选项。
- [设置面板](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/ui-and-presentation/settings-panel.md): 添加运行时设置面板，使用户可以调整麦克风、转录可见性和通知偏好，或以编程方式访问相同设置。
- [运行时设置 API](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/ui-and-presentation/settings-panel/runtime-settings-api.md): IConvaiRuntimeSettingsService 的参考——从代码读取当前设置、应用补丁、响应更改并重置为默认值。
- [自定义 UI 组件](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/ui-and-presentation/customizing-ui-components.md): 使用角色可见性过滤器或预制件替换来重新设计或替换内置的转录、通知和设置 UI。
- [脚本参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/scripting-reference.md): Convai Unity SDK C# 脚本 API 的参考——事件、转录、音频控制和异步操作模式。
- [会话事件](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/scripting-reference/session-events.md): 会话级事件参考，涵盖连接状态、错误、空闲警告和参与者变更，可通过 Inspector 中继或脚本连接。
- [角色事件](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/scripting-reference/character-events.md): 角色级事件参考，涵盖语音、情绪、转录、轮次变化和动作，可通过 Inspector 中继或脚本连接。
- [转录 API](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/scripting-reference/transcript-api.md): 使用转录外观接口从 Unity 脚本查询转录轮次、订阅实时变更、读取字幕并导出会话历史。
- [角色和玩家 API](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/scripting-reference/character-and-player-api.md): 角色与玩家脚本组件参考，涵盖会话控制、语音、音频和注意力目标定位。
- [ConvaiManager API](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/scripting-reference/convaimanager-api.md): 场景管理器组件的每个公共成员，涵盖连接控制、外观访问、玩家正在与谁交谈以及服务发现。
- [音频 API](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/scripting-reference/audio-api.md): Unity SDK 中用于从脚本控制麦克风静音、按角色输出音频以及解锁播放的参考。
- [操作与流类型](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/scripting-reference/operation-and-stream-types.md): 说明 Unity SDK 中所有脚本 API 共享的异步结果和流类型，以及它们解决的问题。
- [异步模式](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/scripting-reference/async-patterns.md): 使用 async/await、协程、链式调用、进度跟踪、取消和流来消费 IConvaiOperation\<T> 和 IConvaiStream\<T>。
- [平台指南](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/platform-guides.md): 在任意受支持的平台上部署 Convai Unity SDK——涵盖在 WebGL、iOS、Android 和 XR 头显上发布前需要额外配置的内容。
- [Windows、macOS 和 Linux](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/platform-guides/windows-macos-and-linux.md): Windows、macOS 和 Linux 构建无需额外 SDK 配置——所有功能，包括视觉、空间音频和屏幕共享，在标准设置后即可工作。
- [WebGL](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/platform-guides/webgl.md): 将 Convai Unity SDK 部署到 WebGL，涵盖 HTTPS、浏览器音频手势、视觉画布捕获以及已知的唇形同步漂移问题。
- [iOS 和 Android](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/platform-guides/ios-and-android.md): 为 iOS 和 Android 构建声明麦克风和摄像头权限——遗漏它们会导致 iOS 崩溃和 Android 静默失败。
- [XR 头显](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/platform-guides/xr-headsets.md): 查找在 XR 头显上部署 Convai Unity SDK 的指南，包括 Meta Quest 视觉透视设置和自定义 XR 帧源实现。
- [Meta Quest Vision 设置](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/platform-guides/meta-quest-vision.md): 说明如何将 Meta Quest 透视摄像头流式传输给 Convai 角色，使其能够看到玩家的真实周围环境。
- [自定义并扩展 SDK](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/advanced-topics.md): 替换 SDK 提供的提供器，使用自己的模块扩展运行时，并借助内置遥测诊断延迟。
- [凭证、身份和存储](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/advanced-topics/custom-providers.md): 将 SDK 的默认凭证、身份和持久化提供器替换为适合你部署环境的自定义实现。
- [自定义凭证提供器](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/advanced-topics/custom-providers/custom-credential-provider.md): 覆盖 SDK 的默认凭证来源，以便从环境变量、密钥库或任何运行时解析的凭证存储中提供 API 密钥。
- [自定义身份提供器](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/advanced-topics/custom-providers/custom-identity-provider.md): 实现自定义终端用户身份提供器，将 Convai 的记忆和 MAU 跟踪与你自己的认证系统、学习者记录或自助终端登录流程绑定。
- [自定义持久化提供器](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/advanced-topics/custom-providers/custom-persistence-provider.md): 将默认会话存储替换为你自己的远程服务、加密文件存储或用于测试的内存实现。
- [个人访问令牌](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/advanced-topics/custom-providers/personal-access-token.md): 从你的后端生成短期令牌，这样真实 API 密钥就不会随 Unity 构建一起发布，从而消除客户端应用中的凭证泄露。
- [运行时模块系统](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/advanced-topics/extending-the-sdk.md): 了解 Convai 运行时模块系统，包括何时使用自定义模块、模块生命周期状态，以及哪些 SDK 扩展点可以安全使用。
- [实现自定义模块](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/advanced-topics/implement-a-custom-module.md): 构建一个自定义运行时模块，该模块随 SDK 启动、访问其服务并响应角色和会话事件。
- [日志、指标和重试策略](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/advanced-topics/performance-and-optimization.md): 按子系统配置 SDK 日志详细级别，将日志路由到自定义接收端，读取 RTVI 管道延迟指标，并调整连接重试策略。
- [故障排查](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/troubleshooting.md): 查找 Convai Troubleshooter 窗口，以及 Unity SDK 中安装、API、音频和调试工具的故障排查指南。
- [Convai Troubleshooter](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/troubleshooting/convai-troubleshooter.md): Convai Troubleshooter 窗口参考，包括如何报告发现、应用修复，以及允许项目添加自己的检查项。
- [安装与包问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/troubleshooting/installation-and-package-issues.md): 修复 Convai Unity SDK 导入失败、不受支持的 Unity 版本、缺失的包依赖项以及启动器启动警告。
- [连接与 API 问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/troubleshooting/connection-and-api-issues.md): 解读 Convai 会话错误代码、查看房间管理器诊断信息，并解决身份验证、传输和限流失败。
- [音频和麦克风问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/troubleshooting/audio-and-microphone-issues.md): 修复所有 Convai Unity SDK 平台上的麦克风输入失败和角色语音播放问题，包括 Android、iOS 和 WebGL。
- [调试工具参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/troubleshooting/debug-tools-reference.md): Convai SDK 调试工具参考，包括 Troubleshooter、按模块分开的编辑器窗口、日志记录和客户端延迟指标。
- [Convai Unreal Engine 插件](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin.md): 查找 Convai Unreal Engine 插件的安装指南、功能文档、Blueprint 参考和故障排查页面。
- [Convai Unreal Engine 插件概览](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/overview.md): 查找关于 Convai Unreal Engine 插件是什么、其五个模块和运行时组件如何组织，以及每个版本有何变化的说明。
- [什么是 Convai Unreal Engine 插件](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/overview/what-is-the-convai-unreal-engine-plugin.md): 了解 Convai Unreal Engine 插件为项目添加了什么：Blueprint 组件、实时语音管线以及可选功能扩展。
- [插件架构](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/overview/plugin-architecture.md): 了解 Convai Unreal Engine 插件的四个模块、运行时组件、会话代理和子系统路由模型。
- [功能地图](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/overview/feature-map.md): 按使用场景查找任何开发目标对应的 Convai Unreal Engine 插件功能、指南或参考页面。
- [发行说明](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/overview/release-notes.md): Convai Unreal Engine 插件的版本历史和重要变更，涵盖公开的 4.x 测试版发布和完整的 3.x 历史。
- [迁移到 4.0.0-beta.27](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/overview/migrate-to-4-0-0-beta-27.md): 将现有 Unreal 项目从之前的插件测试版更新过来，涵盖所有已移除的引脚、已弃用的枚举以及需要刷新的 Blueprint 节点。
- [兼容性与要求](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/compatibility-and-requirements.md): 查找 Convai Unreal Engine 插件支持的 Unreal Engine 版本、平台目标、角色骨骼兼容性和网络要求。
- [Unreal Engine 版本](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/compatibility-and-requirements/unreal-engine-versions.md): Convai Unreal Engine 插件版本支持参考，包括按 UE 版本的模块可用性、加载阶段以及每个版本的设置说明。
- [Unreal Engine 平台支持矩阵](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/compatibility-and-requirements/unreal-engine-platform-support-matrix.md): Convai Unreal Engine 插件平台支持参考，包括构建目标、引擎插件依赖以及 Android 麦克风访问。
- [角色骨架支持](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/compatibility-and-requirements/character-rig-support.md): 哪些角色骨架可与 Convai Unreal Engine 插件配合使用、每种骨架需要什么设置，以及在哪里查找各骨架特定的设置指南。
- [网络和 API 要求](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/compatibility-and-requirements/network-and-api-requirements.md): Convai Unreal Engine 插件网络访问参考，包括 Convai 和 LiveKit 主机、防火墙规则、认证以及会话日志检查。
- [快速开始](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/getting-started.md): 安装 Convai Unreal Engine 插件，配置你的 API 密钥，并放置你的第一个会说话的角色——按顺序完成核心路径以获得最快结果。
- [前提条件](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/getting-started/prerequisites.md): 在将 Convai Unreal Engine 插件安装到项目之前，先验证引擎版本、账户、平台和网络要求。
- [安装 Convai 插件](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/getting-started/install-the-convai-plugin.md): 从 Fab 或 GitHub Releases 安装 Convai Unreal Engine 插件，在项目中启用它，并重启 Unreal Editor。
- [配置你的 API 密钥](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/getting-started/configure-your-api-key.md): 通过 Convai 编辑器窗口登录以存储你的 API 密钥，并允许插件向 Convai 发送已认证请求。
- [场景组件参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/getting-started/scene-components-reference.md): Convai Chatbot、Player、Object 和 Face Sync 组件的参考——它们的字段、运行时属性以及在场景中的连接方式。
- [添加你的第一个 Convai 角色](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/getting-started/add-your-first-convai-character.md): 通过添加 Chatbot 和 Player 组件、设置 Character ID，并在播放模式下测试，在 Unreal Engine 中构建一个会说话的 Convai 角色。
- [设置 MetaHuman 角色](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/getting-started/set-up-a-metahuman-character.md): 向 MetaHuman 添加 Convai Chatbot 和 Face Sync 组件，分配 Convai 动画类，并为 MetaHuman blendshape 配置唇形同步。
- [设置 Reallusion（CC）角色](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/getting-started/set-up-a-reallusion-cc-character.md): 导出 Reallusion CC5 头像，将其导入 Unreal Engine，配置 Convai 组件，并添加 Reallusion 动画 Blueprint 以实现唇形同步。
- [配置麦克风](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/getting-started/configure-the-microphone.md): 选择采集设备、调整音量、测试麦克风，并处理 Android 权限，使玩家语音能够传达到 Convai 角色。
- [配置角色音频](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/getting-started/configure-character-audio.md): 调整角色语音播放音量，启用空间音频衰减，并在 Convai Chatbot 组件上配置打断淡出时长。
- [配置对话输入](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/getting-started/configure-conversation-input.md): 在按住说话和免提语音捕获模式之间切换，调整 VAD 设置，并在没有麦克风的情况下向角色发送文本消息。
- [添加聊天 UI](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/getting-started/add-the-chat-ui.md): 将内置聊天覆盖层添加到场景中，在界面样式之间切换，将 3D 场景内小部件附加到角色上，或将其替换为自定义小部件。
- [验证你的设置](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/getting-started/validate-your-setup.md): 通过插件、组件、音频和 API 密钥检查清单，确认你的 Convai Unreal Engine 设置在添加功能之前已正常工作。
- [Stack O Bot 教程设置](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/getting-started/stack-o-bot-tutorial-setup.md): 构建 Convai 角色动作教程使用的示例项目，从 Epic 的免费 Stack O Bot 开始并应用 Convai 教程文件。
- [核心概念](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/core-concepts.md): 了解 Convai Unreal Engine 插件的组件模型、各组件的所有权以及它们在运行时如何协同工作。
- [运行时架构](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/core-concepts/runtime-architecture.md): 了解 Convai Chatbot、Player、Object、Face Sync 组件与 Convai Subsystem 之间的角色、所有权和关系。
- [会话生命周期](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/core-concepts/session-lifecycle.md): 了解 Convai 会话如何开始和停止，连接状态意味着什么，以及哪些 Blueprint 节点监控全局连接。
- [对话流程](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/core-concepts/conversation-flow.md): 了解语音输入、播放状态、转录事件、动作队列执行、叙事触发器和中断处理。
- [事件系统](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/core-concepts/event-system.md): Convai 组件和子系统上核心运行时 Blueprint 委托的参考，按类别组织并附带时序细节。
- [功能](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features.md): 查找 Convai Unreal Engine 插件所有功能的指南——唇形同步、角色动作、叙事设计、长期记忆、视觉等。
- [角色动作](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/character-actions.md): 查找 Convai Unreal Engine 角色动作系统的指南、参考和示例——从快速开始到 Blueprint API 参考。
- [角色动作的工作原理](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/character-actions/how-character-actions-work.md): 了解 Convai 角色动作如何从会话设置进入排队的 Blueprint 处理器执行，并完成报告。
- [角色动作快速入门](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/character-actions/character-actions-quick-start.md): 启用角色动作，设置 Pawn 移动和导航，注册场景对象，并在播放模式下验证默认移动动作。
- [配置动作](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/character-actions/configuring-actions.md): 定义动作集，启用角色动作，并注册环境对象和角色，以便 Convai 可以引用它们。
- [编写清晰的动作名称和描述](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/character-actions/writing-clear-action-names-and-descriptions.md): 用于命名、描述和测试角色动作的简单示例。
- [内置动作处理器](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/character-actions/built-in-action-handlers.md): 四个默认 Convai 角色动作的参考处理器模式，包括参数、完成规则和 Blueprint 流程。
- [构建自定义动作处理器](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/character-actions/building-custom-action-handlers.md): 添加自定义动作模板，使用编辑器实用工具脚手架创建 Blueprint 处理器，并报告完成以推进队列。
- [参数化动作](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/character-actions/parameterized-actions.md): 声明类型化动作参数，并在 Blueprint 处理器中读取文本、引用、选择和动画的解析值。
- [注意力与引用锚定](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/character-actions/attention-and-reference-grounding.md): 了解 Convai Unreal Engine 插件如何解析代词引用和注意力目标，从而让角色理解玩家指的是哪个对象。
- [动作 Blueprint 参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/character-actions/actions-blueprint-reference.md): 用于支持 Unreal Engine 中 Convai 角色动作的 Blueprint 结构体、枚举、事件和队列函数的参考。
- [角色动作示例](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/character-actions/character-actions-examples.md): 端到端动作方案：导航到已注册对象、跟随角色，以及在 Convai Unreal Engine 插件中使用参数化动作。
- [排查角色动作问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/character-actions/troubleshoot-character-actions.md): 修复 Convai Unreal Engine 插件中不触发的角色动作、移动失败、引用问题和队列停滞。
- [角色移动](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/character-movement.md): 查找让 Convai 角色走向对象、护送玩家到目的地以及编写移动点的指南和参考。
- [角色移动的工作原理](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/character-movement/how-character-movement-works.md): 解释 Convai 如何解析移动目的地、选择移动点、在对象边界上回退，以及定义到达。
- [将角色移动到对象](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/character-movement/move-a-character-to-an-object.md): 连接 Convai Move To 节点，使 AI 控制的角色走向关卡中的 Actor、组件或已编写的移动点。
- [护送角色](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/character-movement/escort-a-character.md): 连接 Convai Escort 节点，使一个角色带领另一个角色前往关卡中的目的地，并在对方落后时等待。
- [编写移动点](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/character-movement/author-movement-points.md): 使用视口可视化器或 Details 面板在 Convai Object Component 上放置命名目的地，以便角色正确接近它。
- [移动 Blueprint 参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/character-movement/movement-blueprint-reference.md): Convai Move To 和 Convai Escort Blueprint 节点的参考，包括它们的输入、输出以及可返回的每种结果代码。
- [排查角色移动问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/character-movement/troubleshoot-character-movement.md): 诊断 Convai Move To 或 Convai Escort 为什么失败、报告了意外结果代码，或始终到达不了目的地。
- [空间感知](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/spatial-awareness.md): 让 Convai 角色以通俗语言感知周围对象、其他角色和玩家的位置，以及其重要性。
- [空间感知的工作原理](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/spatial-awareness/how-spatial-awareness-works.md): 了解距离带、方向、朝向、视线、关系，以及空间事实如何变成角色读取的句子。
- [空间感知快速开始](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/spatial-awareness/spatial-awareness-quick-start.md): 开启空间感知，针对关卡尺度调整距离带，并确认角色实际接收到什么。
- [从玩家视角描述对象](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/spatial-awareness/describe-from-player-perspective.md): 让角色从玩家自己的相机视角而不是自身视角来描述周围环境，从而可以给出方向。
- [合并同名对象](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/spatial-awareness/merge-same-named-objects.md): 合并一堆同名对象，例如一堆箱子，使角色将整组视为一个逻辑整体。
- [空间感知设置参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/spatial-awareness/spatial-awareness-reference.md): 查找所有空间感知和对象命名项目设置、默认值、单位以及启用条件。
- [排查空间感知问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/spatial-awareness/troubleshoot-spatial-awareness.md): 修复角色什么都不描述、把对象隐藏在墙后、把所有东西都读作很远，或混淆重复对象名称的问题。
- [动态上下文](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/dynamic-context.md): 查找通过 Blueprint 节点向 Convai 角色推送实时状态和事件，并验证关卡中具备上下文感知响应的指南。
- [动态上下文的工作原理](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/dynamic-context/how-dynamic-context-works.md): 了解动态上下文如何跟踪运行时状态、批处理事件、选择响应行为并为 Convai 组装载荷。
- [动态上下文快速开始](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/dynamic-context/dynamic-context-quick-start.md): 在 Blueprint 中向已连接的 Convai 角色推送一个状态属性和一个上下文事件，并验证更新是否到达上下文管道。
- [连接时的静态上下文](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/dynamic-context/static-context-at-connection-time.md): 了解哪些已验证的连接数据在会话开始时是固定的，以及实时上下文更新如何使用单独的运行时消息。
- [同步行为与时序](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/dynamic-context/sync-behavior-and-timing.md): 了解动态上下文如何在去抖后刷新、Wait Until Conversation Is Idle 如何保持更新，以及离线排队如何工作。
- [动态上下文 Blueprint 参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/dynamic-context/dynamic-context-blueprint-reference.md): 参考从 Unreal 角色在实时会话中向 Convai 发送运行时状态、事件、重置、时序和传递更新的 Blueprint 控件。
- [动态上下文使用示例](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/dynamic-context/dynamic-context-usage-examples.md): 用于健康追踪、上下文事件、短暂提示、区域转换、状态移除以及训练模拟中的动态上下文重置的 Blueprint 方案。
- [排查动态上下文问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/dynamic-context/troubleshoot-dynamic-context.md): 修复动态上下文更新到达过晚、触发意外响应，或在刷新或重新连接后看似被忽略的问题。
- [情绪](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/emotion.md): 查找让 Convai 角色表达与对话同步的指南——从快速 Blueprint 设置到完整参考和故障排查。
- [情绪系统的工作原理](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/emotion/how-the-emotion-system-works.md): 了解 Convai 如何以每种情绪的分数形式传递情绪状态，服务器比例如何映射到分数值，以及偏移和锁定控件的作用。
- [情绪快速入门](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/emotion/emotion-quick-start.md): 将 Convai 角色的情绪分数连接到其 Skeletal Mesh 上的 morph target，使面部表情在对话期间自动更新。
- [情绪 Blueprint 参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/emotion/emotion-blueprint-reference.md): Convai Chatbot 组件上的情绪属性、函数、事件和枚举参考——包括类型、默认值和参数细节。
- [情绪示例](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/emotion/emotion-examples.md): 六个场景涵盖强制表情、过场锁定、基于分数的 VFX、偏移调节、中性重置和 Animation Blueprint 混合姿势。
- [排查情绪问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/emotion/troubleshoot-emotion.md): 修复常见情绪问题——表情不显示、状态被意外锁定、morph target 不匹配，以及偏移更改没有可见效果。
- [长期记忆](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/long-term-memory.md): 查找在 Unreal Engine 中启用长期记忆、识别玩家、恢复会话和排查回忆问题的指南。
- [长期记忆的工作原理](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/long-term-memory/how-long-term-memory-works.md): 了解 Unreal 长期记忆如何使用角色设置、玩家身份和连接时参数来回忆先前交互。
- [长期记忆快速开始](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/long-term-memory/long-term-memory-quick-start.md): 为 Unreal 角色设置长期记忆，分配稳定的玩家身份，并确认在 Play In Editor 会话之间的回忆。
- [为角色配置记忆](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/long-term-memory/configure-memory-for-a-character.md): 为 Unreal 角色启用长期记忆，验证仪表板设置，并在需要时重置本地对话链接。
- [终端用户身份](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/long-term-memory/end-user-identity.md): 配置稳定的 Unreal 玩家身份，以便每个 Convai 角色在会话开始前为正确用户加载记忆。
- [说话者 ID 管理](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/long-term-memory/speaker-id-management.md): 从 Unreal Blueprints 中创建、列出和删除说话者 ID 记录，以便每个玩家在会话间保持稳定的记忆身份。
- [LTM Blueprint 参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/long-term-memory/ltm-blueprint-reference.md): Unreal 长期记忆 Blueprint 节点、说话者 ID 数据、组件属性以及启动期间使用的会话字段的参考。
- [长期记忆使用示例](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/long-term-memory/long-term-memory-usage-examples.md): 将 Unreal 长期记忆模式应用于回归学习者、共享设备、首次会话和全新开始的重置流程。
- [排查长期记忆问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/long-term-memory/troubleshoot-long-term-memory.md): 诊断已禁用记忆、不稳定的玩家身份、说话者身份失败以及 Unreal 角色在共享设备上的回忆问题。
- [叙事设计](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/narrative-design.md): 通过调用叙事触发器、注入模板键以及处理区段变化事件，从 Unreal Engine 驱动角色故事图。
- [叙事设计的工作原理](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/narrative-design/how-narrative-design-works.md): 了解叙事设计故事图、推进区段的运行时管道，以及触发器和模板键如何塑造角色行为。
- [叙事设计快速开始](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/narrative-design/narrative-design-quick-start.md): 从 Blueprint 调用一个命名的叙事触发器，并通过将新的区段 ID 打印到屏幕上来确认区段变化。
- [叙事触发器](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/narrative-design/narrative-triggers.md): 在 Convai chatbot 组件上调用命名叙事触发器或动态上下文消息，以推进故事图并处理区段变化事件。
- [模板键](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/narrative-design/template-keys.md): 在 chatbot 组件上填充 Narrative Template Keys 映射，使区段目标通过占位符替换引用实时游戏值。
- [获取叙事数据](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/narrative-design/fetching-narrative-data.md): 在运行时使用 Convai Fetch Narrative Sections 和 Convai Fetch Narrative Triggers 查询角色的叙事区段和触发器。
- [叙事设计 Blueprint 参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/narrative-design/narrative-design-blueprint-reference.md): Narrative design API 中 UConvaiChatbotComponent 上 Blueprint 函数、事件、属性和叙事结构体的参考。
- [叙事设计使用示例](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/narrative-design/narrative-design-usage-examples.md): 用于线性场景推进、动态上下文事件、模板键注入以及叙事设计中触发器名称验证的 Blueprint 方案。
- [排查叙事设计问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/narrative-design/troubleshoot-narrative-design.md): 诊断并修复叙事设计问题，包括缺少区段事件、错误转换、模板键被忽略以及获取失败。
- [场景元数据](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/scene-metadata.md): 查找指南、参考页面和示例，了解如何让 Convai 角色感知 Unreal Engine 关卡中的对象。
- [场景元数据的工作原理](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/scene-metadata/how-scene-metadata-works.md): 了解场景对象元数据如何在连接时、通过实时更新以及通过跟踪属性变化传递给 Convai。
- [场景元数据快速开始](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/scene-metadata/scene-metadata-quick-start.md): 用 Convai Object Component 标记一个世界 Actor，分配其名称和描述，并确认 Convai 角色可以在对话中引用它。
- [场景元数据组件参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/scene-metadata/scene-metadata-component-reference.md): Convai Object Component 的完整属性、函数和事件参考，包括对象标识、跟踪属性、接近状态和注视事件。
- [运行时管理环境](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/scene-metadata/managing-the-environment-at-runtime.md): 用于 chatbot 环境方法的参考，这些方法在活动游戏会话期间添加、移除和更新对象和角色。
- [场景元数据使用示例](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/scene-metadata/scene-metadata-usage-examples.md): 在 Unreal Engine 中为训练模拟、工业演练、军事基地和运行时环境更新提供完整的场景元数据设置。
- [排查场景元数据问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/scene-metadata/troubleshoot-scene-metadata.md): 诊断并修复场景对象未被识别、环境数据过时以及跟踪属性更新失败等常见问题。
- [Scene Auto Tagger](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/scene-metadata/scene-auto-tagger.md): 使用 Scene Auto Tagger 为场景对象添加名称和描述，查看建议，并应用它们供你的 Convai 角色使用。
- [视觉](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/vision.md): 在 Unreal Engine 中为 Convai 角色提供场景视觉，使其能够在对话期间对关卡中可见的内容作出反应。
- [视觉的工作原理](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/vision/how-vision-works.md): 了解 Unreal 视觉组件如何被发现、启动、限流，以及如何在 Convai 会话期间用于发送场景帧。
- [视觉快速开始](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/vision/vision-quick-start.md): 将场景视觉添加到 Convai 角色 Blueprint，并验证捕获的帧会在 Play In Editor 中影响角色的响应。
- [视觉帧源](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/vision/vision-frame-sources.md): 配置内置的 Environment Webcam 帧源，创建其渲染目标，并在运行时选择活动视觉组件。
- [自定义视觉组件](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/vision/custom-vision-components.md): 为需要向 Convai chatbot 提供场景帧的自定义 Unreal 图像管道实现一个 C++ 帧源组件。
- [视觉 Blueprint 参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/vision/vision-blueprint-reference.md): Blueprint 可访问的视觉枚举、Environment Webcam 属性、摄像头节点、事件和 Chatbot 集成功能的参考。
- [视觉使用示例](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/vision/vision-usage-examples.md): 应用 Unreal 视觉的常见 Blueprint 模式，包括自动启动捕获、手动控制、FPS 调优和源切换。
- [排查视觉问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/vision/troubleshoot-vision.md): 修复常见 Unreal 视觉问题，包括缺少视觉上下文、启动失败、空白渲染目标和无效源注册。
- [注视注意力](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/gaze-attention.md): 查找注视注意力系统的指南和参考，该系统允许玩家通过注视世界对象来引导 Convai 角色的注意力。
- [注视注意力的工作原理](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/gaze-attention/how-gaze-attention-works.md): 了解注视追踪管道、注意力提升计时器、组件作用域目标、高亮渲染以及注意力源锁定规则。
- [注视注意力快速开始](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/gaze-attention/gaze-attention-quick-start.md): 在 Convai Player Component 上启用注视注意力，并验证当玩家注视带标签的世界对象时角色会作出响应。
- [注视注意力参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/gaze-attention/gaze-attention-reference.md): 注视注意力系统的完整属性、事件、方法和类参考，包括所有默认值和版本特定行为。
- [注视注意力使用示例](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/gaze-attention/gaze-attention-usage-examples.md): 用于注视事件、自定义高亮视觉、组件作用域目标、手动注意力锁定以及构建自定义光标小部件的 Blueprint 方案。
- [排查凝视注意力问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/gaze-attention/troubleshoot-gaze-attention.md): 诊断并修复凝视注意力问题——对象未高亮、注意力从不提升、光标不出现，以及组件范围内的凝视不匹配。
- [口型同步](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/lip-sync.md): 使用预计算的 blendshape 数据和 Convai Face Sync AnimGraph 节点，让角色面部动作与 Convai 语音同步。
- [口型同步的工作原理](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/lip-sync/how-lip-sync-works.md): 了解 Convai 如何在音频之外提供面部动画数据、支持的口型同步模式，以及 AnimGraph 节点如何应用这些数据。
- [口型同步快速入门](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/lip-sync/lip-sync-quick-start.md): 将 Convai Face Sync 组件和 Convai 动画类添加到 MetaHuman 角色，并在编辑器中运行时听到口型同步语音。
- [Face Sync 组件参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/lip-sync/face-sync-component-reference.md): Convai Face Sync 组件的属性参考，以及全部六种口型同步模式值，并提供 MetaHuman、CC4、CC5 和自定义骨骼的绑定兼容性指导。
- [Face Sync AnimGraph 节点参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/lip-sync/face-sync-animgraph-node-reference.md): Convai Face Sync AnimGraph 节点的全部属性参考——应用模式、面部 alpha、平滑、饥饿混合和 blendshape 映射。
- [录制并回放口型同步](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/lip-sync/record-and-replay-lip-sync.md): 在 Convai 对话期间捕获实时口型同步序列，并在之后的过场动画、缓存响应或离线预览中回放，无需重新流式传输。
- [口型同步使用示例](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/lip-sync/lip-sync-usage-examples.md): 为常见场景配置口型同步：叠加与覆盖混合、平滑调优、与身体动画混合，以及将 blendshape 重新映射到自定义骨骼。
- [排查口型同步问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/lip-sync/troubleshoot-lip-sync.md): 诊断并修复 Convai Unreal Engine 插件中的口型同步问题——没有嘴部动作、帧饥饿、blendshape 映射错误，以及骨骼不匹配。
- [AI 编码助手](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/ai-coding-assistant.md): 将受支持的编码代理连接到 Unreal 编辑器，以便它为你设置 Convai 角色并读取 Convai 的技能库。
- [AI 编码助手快速入门](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/ai-coding-assistant/quick-start.md): 在 Convai 编辑器窗口中打开“设置 AI 编码”，选择一个编码代理，重启编辑器，并确认 Convai 工具已注册。
- [受支持的编码代理](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/ai-coding-assistant/supported-coding-agents.md): AI 编码设置支持的五种编码代理参考，包括每个代理的上下文文件、终端支持和选项。
- [Convai 工具集参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/ai-coding-assistant/convai-toolset-reference.md): 可由连接的编码代理调用的七个编辑器操作参考，用于设置 Convai 角色、玩家和动作。
- [Convai AgentSkills](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/ai-coding-assistant/convai-agent-skills.md): 17 份已提供技能文档的参考，用于教会连接的编码代理了解插件中每个 Convai 功能的行为方式。
- [高级主题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/advanced-topics.md): 查找 Convai Unreal Engine 插件核心设置路径之外的生产环境身份验证、安全和集成指南。
- [使用个人访问令牌](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/advanced-topics/personal-access-token.md): 在后端生成一个短期令牌并将其传递给 Unreal 插件，这样生产构建就不会打包真实 API 密钥。
- [Blueprint 参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/blueprint-reference.md): 查找 Convai Unreal Engine 插件运行时工作流的已验证 Blueprint 组件、工具、音频和共享数据参考。
- [Convai 聊天机器人组件](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/blueprint-reference/convai-chatbot-component.md): AI 角色组件参考——Convai Chatbot Component 暴露的每个 Blueprint 可见属性、函数和事件。
- [Convai 玩家组件](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/blueprint-reference/convai-player-component.md): 玩家对话组件参考——Convai Player Component 暴露的每个 Blueprint 可见属性、函数和事件。
- [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): 对象组件参考——Convai Object Component 暴露的每个 Blueprint 可见属性、函数和事件。
- [麦克风和音频捕获](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/blueprint-reference/microphone-and-audio-capture.md): Convai Player Component 和麦克风子系统中麦克风设备枚举、选择、音量以及持久化设置的参考。
- [Convai 工具函数](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/blueprint-reference/convai-utility-functions.md): 查找用于凝视查询、组件查找、音频工具、设置、诊断和命令行标志的跨领域 Blueprint 帮助节点。
- [数据类型和枚举](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 编辑器窗口](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/editor-window.md): 打开 Convai 编辑器窗口，了解其主要部分，并找到账户、更新、支持和日志导出工作流。
- [登录并管理你的账户](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/editor-window/sign-in-and-manage-your-account.md): 通过编辑器窗口连接你的 Convai 账户，注销以切换账户，并在 Unreal Editor 中查看套餐、配额和使用详情。
- [浏览示例和内容](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/editor-window/browse-samples-and-content.md): 查看 Convai Editor 窗口中的当前 Samples 区域，并了解示例项目将在未来更新中如何展示。
- [导出诊断日志](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/editor-window/export-diagnostic-logs.md): 从 Unreal Editor 导出 Convai 诊断信息，并将生成的日志包附加到 Convai Developer Forum 支持请求中。
- [故障排查](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/troubleshooting.md): 查找 Convai Unreal Engine 插件中的安装、API 密钥、音频、口型同步和连接问题的修复方法，以及日志导出和诊断指南。
- [安装和插件问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/troubleshooting/installation-and-plugin-issues.md): 修复 Convai Unreal Engine 插件中的插件未找到错误、模块加载失败、仅 Blueprint 项目限制和 Android 打包错误。
- [连接和 API 密钥问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/troubleshooting/connection-and-api-key-issues.md): 修复 Convai Unreal Engine 插件中的身份验证失败、缺少 API 密钥错误、会话超时和防火墙问题。
- [音频和麦克风问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/troubleshooting/audio-and-microphone-issues.md): 修复 Convai Unreal Engine 插件中的音频捕获失败、麦克风设备错误、Android 权限错误和音频播放问题。
- [口型同步和动画问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/troubleshooting/lip-sync-and-animation-issues.md): 修复 Convai Unreal Engine 插件中的嘴部不动、blendshape 曲线错误、帧饥饿以及打包构建中的动画失败。
- [诊断和日志导出](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/troubleshooting/diagnostics-and-log-export.md): Convai Unreal Engine 插件的日志类别、详细程度、配置默认值、Blueprint 诊断节点以及日志文件导出的参考。
- [使用 Convai 调试覆盖层检查角色](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/troubleshooting/convai-debug-overlay.md): 开启游戏内覆盖层，查看 Convai 角色当前拥有的上下文、事实、周边文本和动作队列。
- [Convai 调试覆盖层参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/troubleshooting/convai-debug-overlay-reference.md): 游戏内 Convai 调试覆盖层暴露的每个面板、图标、按键和设置，以及准确的屏幕标签、颜色和键盘快捷键。
- [Web 插件](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins.md): 将 Convai AI 集成到你的网站。按照我们的 Web 插件文档即可轻松完成设置。
- [Convai Web SDK](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-web-sdk.md): 探索 Convai Web SDK——面向浏览器的快速、低延迟、语音优先 AI 角色交互
- [React](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-web-sdk/react.md): 了解如何安装、配置并集成 Convai Web SDK（@convai/web-sdk），将低延迟对话式 AI、语音交互和可选视频引入你的 Web 应用。
- [useConvaiClient Hook](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-web-sdk/react/useconvaiclient-hook.md): useConvaiClient 管理所有 Convai 连接逻辑、音频/视频管线和消息流。
- [ConvaiWidget](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-web-sdk/react/convaiwidget.md): ConvaiWidget 是一个集成语音、文本、视频和屏幕共享的一体化界面。
- [实时口型同步](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-web-sdk/react/real-time-lipsync.md): 在你的 React 应用中集成实时面部动画。
- [自定义 UI 与高级用法](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-web-sdk/react/custom-ui-and-advanced-usage.md): 在使用 Convai 的音频管线和消息系统的同时构建你自己的 UI。
- [音频可视化器（可选）](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-web-sdk/react/audio-visualizer-optional.md): 你可以使用 Web Audio + WebRTC 房间从机器人的音频创建实时可视化效果。
- [原生 TypeScript](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-web-sdk/vanilla-typescript.md): 在原生 TypeScript 应用中使用 @convai/web-sdk 的完整指南（无需 React 或框架）。直接使用 ConvaiClient 类，连接事件，并构建你自己的 UI。
- [ConvaiClient（核心 API）](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-web-sdk/vanilla-typescript/convaiclient-core-api.md): 框架无关的 Convai Web SDK 客户端的配置、连接、消息传递和事件处理参考，包括动作结果。
- [事件与消息处理](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-web-sdk/vanilla-typescript/events-and-message-handling.md): ConvaiClient 提供强类型事件系统。使用 client.on(event, handler) 进行订阅。
- [实时口型同步](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-web-sdk/vanilla-typescript/real-time-lipsync.md): 在原生 JavaScript/TypeScript 应用中集成实时面部动画。
- [构建自定义 UI（TypeScript）](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-web-sdk/vanilla-typescript/building-a-custom-ui-typescript.md): 此页面展示了如何使用原生 TypeScript 连接一个简单的基于 DOM 的聊天 UI。
- [最佳实践与类型定义](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-web-sdk/vanilla-typescript/best-practices-and-type-definitions.md): 推荐模式摘要以及主要 TypeScript 类型，便于快速查阅。
- [映射参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-web-sdk/vanilla-typescript/mappings-reference.md)
- [快速开始](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-web-sdk/quickstart.md): 让一个 Convai 角色在五分钟内在你的应用中开口说话。
- [口型同步与 Blendshape](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-web-sdk/lipsync-and-blendshape.md): 使用与机器人音频一起流式传输的 blendshape 数据，为 3D 角色驱动实时面部动画。
- [MetaHuman 限制驱动——\`mha\` 必需](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-web-sdk/lipsync-and-blendshape/metahuman-limit-drivers-required-for-mha.md)
- [动作](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-web-sdk/actions.md): 配置语义动作或关联客户端工具，处理带类型输出，返回执行结果，并保留旧版 Web SDK 行为。
- [情绪](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-web-sdk/emotions.md): 启用情绪检测，以在对话期间接收角色的情绪状态。启用情绪检测，以在每次回复时一并接收角色的情绪状态。
- [动态上下文](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-web-sdk/dynamic-context.md): 将实时上下文注入角色的理解中——游戏状态、用户偏好、场景变化——无需重新连接。
- [长期记忆](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-web-sdk/long-term-memory.md): Convai 可以跨会话记住有关你用户的信息。提供 \`endUserId\` 后，角色会自动构建并回忆长期记忆。
- [身份验证令牌](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-web-sdk/auth-tokens.md): 对于生产应用，请使用短期身份验证令牌，而不是把 Convai API 密钥嵌入客户端代码。API 密钥保留在服务器上；客户端接收一个 1 小时后过期的令牌。
- [错误处理](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-web-sdk/error-handling.md): SDK 通过四个通道报告错误。每个通道的作用域和负载都不同——了解在特定场景下该用哪个通道，是构建可靠应用的关键。
- [WebSocket 传输层](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-web-sdk/websocket-transport-layer.md): SDK 默认使用 WebRTC 进行实时语音对话。在 WebRTC 不可用的环境中，你可以改用基于 WebSocket 的传输。
- [事件参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-web-sdk/event-reference.md): 订阅 Convai Web SDK 中连接、对话、语音、动作、会话、媒体和确认事件的参考。
- [Convai Web SDK（旧版）](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-web-sdk-1.md): 在你自己的 Web 应用中集成 Convai 对话服务
- [入门](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-web-sdk-1/getting-started.md): 使用我们的 Web SDK 快速入门指南开始构建应用
- [面部表情](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-web-sdk-1/facial-expressions.md): 本部分提供关于在 Web 应用中使用 convai-web-sdk 集成和处理面部表情与口型同步的全面信息。
- [动作](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-web-sdk-1/actions.md): 对于已弃用的无作用域 Web SDK，请遵循保留的动作工作流；或者迁移到当前 Convai Web SDK 的动作事件和配置界面。
- [PlayCanvas 插件](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/playcanvas-plugin.md): 用于 Convai 集成的 PlayCanvas 模板。
- [添加外部脚本](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/playcanvas-plugin/adding-external-script.md): 添加外部脚本——Convai 集成的 PlayCanvas 插件指南。
- [第一人称视角](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/playcanvas-plugin/first-person-view.md): 第一人称视角——Convai 集成的 PlayCanvas 插件指南。
- [将角色添加到场景](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/playcanvas-plugin/adding-characters-to-scene.md): 将角色添加到场景——Convai 集成的 PlayCanvas 插件指南。
- [角色动画](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/playcanvas-plugin/character-animations.md): 使用 Convai 在 PlayCanvas 中添加角色动画。用交互式 AI 增强你的 Web 项目。
- [Convai 集成](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/playcanvas-plugin/convai-integration.md): Convai 集成——用于无缝集成的 PlayCanvas 插件指南。
- [聊天覆盖层](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/playcanvas-plugin/chat-overlay.md): 聊天覆盖层——Convai 集成的 PlayCanvas 插件指南。
- [叙事设计指南](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/narrative-design-guide.md): 叙事设计——基于叙事的 Web 端 Convai NPC。
- [叙事设计触发器](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/narrative-design-guide/narrative-design-triggers.md)
- [叙事设计键](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/narrative-design-guide/narrative-design-keys.md): 本指南展示了如何动态向叙事设计部分和触发器传递变量
- [Convai 的 GLB 角色](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/glb-characters-for-convai.md): 了解如何在 Convai 的 Web 插件中使用 GLB 角色，打造沉浸式虚拟体验。
- [Convai 的 GLB/FBX 动画](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/glb-fbx-animations-for-convai.md): 学习如何将 GLB 和 FBX 动画集成到 Convai 的 Web 插件中，以实现动态角色动作。
- [Modding 框架](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/modding-framework.md): Convai 引入了 Modding 框架，使得可以轻松将 AI 驱动的 NPC 集成到 Unreal、Unity 等不同引擎的游戏中。
- [为 Cyberpunk 2077 制作 Mod](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/modding-framework/modding-cyberpunk-2077.md): 本指南将向你展示如何制作将 Convai 功能添加到 Cyberpunk 2077 的 Mod
- [其他集成](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/other-integrations.md)
- [Roblox](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/other-integrations/roblox.md): 在 Roblox 游戏中集成 Convai 角色聊天机器人服务。
- [示例游戏 1](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/other-integrations/roblox/sample-game-1.md): 在 Convai 的简单实现中与角色互动
- [示例游戏 2](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/other-integrations/roblox/sample-game-2.md): 在不同环境中与智能角色互动并探索它。
- [代码示例](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/other-integrations/roblox/code-example.md): 来自 Roblox 的 API 请求代码
- [角色对话 API](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/other-integrations/roblox/code-example/character-conversation-api.md): 角色对话 API——Convai 与 Roblox 集成的代码示例。
- [Discord](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/other-integrations/discord.md): 将 Convai 角色与 Discord Bot 集成
- [创建 Discord Bot](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/other-integrations/discord/create-a-discord-bot.md): 创建你自己的 Discord Bot，与不同服务器中的人分享。
- [从个人服务器托管 Discord Bot](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/other-integrations/discord/hosting-discord-bot-from-personal-server.md): 成功托管一个连接到 Convai API 的 Discord Bot 服务器
- [从 Replit 托管 Discord Bot](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/other-integrations/discord/hosting-discord-bot-from-replit.md): 成功从 Replit 托管一个连接到 Convai API 的 Discord Bot 服务器
- [Omniverse 扩展](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/other-integrations/omniverse-extension.md): 本指南将向你展示如何使用 Convai Extension 插件集成 Convai 和 NVIDIA Omniverse。
- [第三方 API 集成](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/other-integrations/third-party-api-integrations.md): 集成 ElevenLabs 等外部 API，为你的应用增强高级功能。
- [ElevenLabs API 集成](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/other-integrations/third-party-api-integrations/elevenlabs-api-integration.md): 这是一份关于如何将你的 ElevenLabs 声音与 Convai 角色集成的指南
- [Convai Pixel Streaming 嵌入](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-pixel-streaming-embed.md)
- [白名单与发布体验](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-pixel-streaming-embed/whitelisting-and-publishing-an-experience.md): 从 Avatar Studio 发布场景并将允许嵌入它的域名列入白名单，让你的体验只在你控制的网站上加载。
- [React TypeScript](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-pixel-streaming-embed/react-typescript.md): 使用 @convai/experience-embed 在你的 React TypeScript 应用中设置并集成 Convai 的 Pixel Streaming 组件。
- [ReactJS（JavaScript）](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-pixel-streaming-embed/reactjs-javascript.md): 使用 @convai/experience-embed 组件将 Convai 的 Pixel Streaming 集成到你的 React JavaScript 应用中。
- [原生 JavaScript（ES Modules）](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-pixel-streaming-embed/vanilla-javascript-es-modules.md): 在支持原生 ES 模块的基于浏览器的 JavaScript 应用中直接使用 Convai 的 Pixel Streaming 客户端。
- [CDN（UMD 脚本）](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-pixel-streaming-embed/cdn-umd-script.md): 通过直接从 CDN 获取的 UMD 构建，将 Convai 的 Pixel Streaming 集成到你的 Web 应用中
- [本地部署](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-pixel-streaming-embed/on-premise-deployment.md): 配置 Convai 的 Pixel Streaming 客户端，使其连接到你自己的后端和流媒体服务器，用于本地或自托管部署。
- [API 参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-pixel-streaming-embed/api-reference.md): 探索在 React、原生 JS、TypeScript 和 CDN 设置中使用 Convai Pixel Streaming 客户端时可用的 props、选项和方法。
- [资源上传器](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/asset-uploader.md): 使用 Convai 资源上传器工具，将 Metahuman、Reallusion 角色以及场景从 Unreal Engine 上传到 Convai Sim 和 Avatar Studio。
- [将你的 Unreal Engine 5.5 Convai 资源迁移到 5.8](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/asset-uploader/migrate-your-unreal-engine-5.5-convai-assets-to-5.8.md): 使用资源上传器工具，将现有的 Unreal Engine 5.5 Convai 资源项目迁移到当前受支持的 Unreal Engine 版本。


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.