> 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/unity-plugin-beta-overview/features.md).

# 功能

- [动作](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/actions.md): 让 AI 角色具备根据玩家所说内容采取行动的能力。涵盖完整的 Action 系统——架构、配置、执行器和运行时控制。
- [快速开始](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/actions/quick-start.md): 您的第一个可运行 Convai Action 的分步教程——从添加组件到在 Play Mode 中测试实时命令。
- [配置 Actions](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/actions/configuring-actions.md): 定义可用操作，将场景对象和角色注册为目标，并使用 ConvaiActionConfigSource 配置执行器绑定。
- [Action 执行器](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/actions/action-executors.md): SDK 中包含的每个执行器的参考——行为、配置字段以及各自的使用场景。
- [分发器与批处理策略](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/actions/dispatcher-and-batch-policies.md): 控制分发器如何排列 action 批次、解决命令冲突，并通过其 UnityEvent API 暴露生命周期事件。
- [编写自定义执行器](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/actions/writing-custom-executors.md): 实现 IConvaiActionExecutor 以创建项目所需的任意行为——包含完整示例、取消处理和复合操作模式。
- [注意力与引用锚定](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/actions/attention-and-reference-grounding.md): 后端如何解析含糊的玩家引用——以及对象描述和当前注意力对象如何影响目标解析。
- [调试与故障排查](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/actions/debugging-and-troubleshooting.md): 使用内置调试探针、控制台日志参考和诊断检查清单识别并解决 Action 流水线问题。
- [动态上下文](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/dynamic-context.md): 将实时游戏状态注入 Convai 角色的感知中，使其能够在对话中自然地引用环境、玩家行为和模拟事件。
- [快速开始](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/dynamic-context/quick-start.md): 第一个可用的动态上下文集成的分步教程——一个知道玩家站在哪里的角色，并且只需一次按钮点击即可更新。
- [命令组件参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/dynamic-context/command-component-reference.md): 动态上下文命令组件上的每个字段、命令类型和事件——从 Unity 检查器驱动角色感知的完整参考。
- [连接时的静态上下文](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/dynamic-context/static-context-at-connection-time.md): 在角色说出第一句话之前先确定它已知的信息——一个贯穿整个对话的固定场景描述。
- [使用示例](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/dynamic-context/usage-examples.md): 四个完整的模拟场景——安全演练、新手引导、导览和紧急切换——每个场景都展示不同的上下文策略。
- [脚本 API 参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/dynamic-context/scripting-api-reference.md): 动态上下文脚本接口上每个方法、参数和返回值的完整参考——适用于从游戏代码驱动角色感知的开发者。
- [同步行为与时序](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/dynamic-context/sync-behavior-and-timing.md): 精确说明上下文更新何时到达角色、对话开始前会发生什么，以及 SDK 如何决定发送哪些内容。
- [故障排查与诊断](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/dynamic-context/troubleshooting-and-diagnostics.md): 诊断最常见的动态上下文问题——从忽略上下文更新的角色到会话重置后的异常行为。
- [情绪](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/emotion.md): 情绪系统如何工作、每个组件的作用，以及下一步该去哪里——为任何 Convai 角色添加面部情绪的起点。
- [快速开始](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/emotion/quick-start.md): 分步设置教程，最终让 Convai 角色对实时对话产生情绪反应。
- [情绪配置文件](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/emotion/emotion-profile.md): 所有可配置参数都集中在一处——表情上升和消退的速度、微脉冲如何增加自然感，以及中性轮换如何防止面部僵住。
- [输出绑定](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/emotion/output-bindings.md): 将每种情绪映射到角色骨骼上的特定面部形状或 Animator 参数，并为每个槽位设置权重与 LipSync 协调。
- [情绪分类法](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/emotion/emotion-taxonomy.md): 将后端标签与角色表情连接起来的情绪词汇——其工作方式、内置集合包含哪些内容，以及如何扩展它。
- [脚本 API 参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/emotion/scripting-api-reference.md): 读取实时情绪状态，从代码驱动表情，对情绪事件作出反应，并在脚本场景期间将角色锁定为特定情绪。
- [使用示例](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/emotion/usage-examples.md): 展示情绪系统实际运行的示例场景：危险响应、脚本化问候、自适应分支、分析和创作工作流。
- [故障排查与诊断](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/emotion/troubleshooting-and-diagnostics.md): 针对最常见的情绪系统问题提供分步修复方案——从表情无法变化到 LipSync 冲突和发布构建中的坑。
- [长期记忆](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/long-term-memory.md): 让您的 Convai 角色在不同会话之间持续记住单个用户。了解此功能的工作方式并浏览完整参考文档。
- [快速开始](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/long-term-memory/quick-start.md): 为角色启用记忆，并使用 Convai 控制台和 Unity 编辑器验证跨会话回忆。
- [终端用户身份](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/long-term-memory/end-user-identity.md): 了解 SDK 如何在会话之间识别用户，以及如何用您自己的账户范围身份系统替换默认的设备基础提供方。
- [为角色启用记忆](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/long-term-memory/enabling-memory-on-characters.md): 可通过 Convai 控制台或 CharacterService 脚本 API 为每个角色启用或禁用长期记忆。默认关闭——需明确启用。
- [记忆管理 API](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/long-term-memory/memory-management-api.md): 使用 MemoryService 脚本 API 以编程方式为任意用户-角色对添加、列出、检索和删除单条记忆记录。
- [终端用户管理](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/long-term-memory/end-user-management.md): 使用配置窗口或 EndUsersService API 浏览和管理终端用户记录。包括分页、元数据编辑和安全删除。
- [使用示例](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/long-term-memory/usage-examples.md): 四种常见长期记忆场景的完整可运行代码：自动持久化、账户范围身份、首次会话前的记忆预置以及定向重置。
- [故障排查与诊断](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/long-term-memory/troubleshooting-and-diagnostics.md): 诊断长期记忆为什么没有持久化，解决身份和 API 错误，并使用内置诊断工具在运行时验证已存储的记忆。
- [叙事设计](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/narrative-design.md): 适用于 Convai AI 角色的结构化叙事图——章节、触发器和模板键如何在运行时汇聚，以创建可感知状态的体验，并适应每个玩家行为。
- [快速开始](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/narrative-design/quick-start.md): 完整演示以检查器优先的设置——Manager、Trigger 和碰撞体区域——并追踪从玩家交互到 Play Mode 中确认章节切换的完整信号路径。
- [设置叙事设计管理器](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/narrative-design/setting-up-the-narrative-design-manager.md): ConvaiNarrativeDesignManager 控制的一切——章节同步、每章节 Unity 事件、全局过渡回调，以及确认控制台返回内容的同步状态字段。
- [设置叙事设计触发器](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/narrative-design/setting-up-narrative-design-triggers.md): 全面解析 ConvaiNarrativeDesignTrigger 的四种激活模式——Collision、Proximity、TimeBased、Manual——以及队列系统、TriggerStatus 状态和每个触发器的 Unity 事件。
- [模板键：动态叙事变量](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/narrative-design/template-keys-dynamic-narrative-variables.md): 通过键值对将运行时值注入角色的叙事目标——可从检查器或代码进行——并在会话打开和重连时自动传递。
- [叙事设计脚本编写](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/narrative-design/scripting-narrative-design.md): 叙事设计的完整 C# 接口——IConvaiNarrativeDesign 事件、InvokeTrigger、带 speak 标签的 InvokeSpeech、异步章节获取以及运行时触发器重配置。
- [使用示例](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/narrative-design/usage-examples.md): 四个复杂度逐步增加的示例——从单一触发器的欢迎序列到自适应多章节场景——展示如何在实践中组合叙事设计组件。
- [故障排查与诊断](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/narrative-design/troubleshooting-and-diagnostics.md): 使用内置验证工具、诊断日志器和 PrintDiagnostics 输出解决每一种 TriggerStatus 状态、常见的检查器配置错误、获取失败和队列超时问题。
- [视觉](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/vision.md): 让 Convai 角色能够实时感知并响应您的 Unity 场景。Vision 功能、其组件和平台支持概览。
- [快速开始](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/vision/quick-start.md): 最短路径的 Vision 工作配置。通过检查器添加帧源和发布器，验证流，并了解运行时会发生什么。
- [帧源](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/vision/frame-sources.md): 为您的平台选择并配置合适的帧源。涵盖所有检查器字段、捕获预设、平台要求和源状态诊断。
- [发布与策略](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/vision/publishing-and-policies.md): 控制 Vision 帧如何传递到后端。涵盖发布策略、帧率和比特率配置，以及手动发布控制。
- [调试预览](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/vision/debug-preview.md): 在 Unity 编辑器中通过实时叠加层验证 Vision 捕获，显示当前活动帧源、捕获统计和源状态。
- [使用示例](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/vision/usage-examples.md): 四种端到端 Vision 配置，覆盖场景摄像机、物理网络摄像头、Meta Quest 透视，以及手动触发发布工作流。
- [高级主题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/vision/advanced-topics.md): 脚本 API 参考、自定义帧源实现、域事件、WebGL 平台行为以及跨平台兼容性。
- [故障排查与诊断](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/vision/troubleshooting-and-diagnostics.md): 使用结构化检查清单和决策树诊断并解决 Vision 问题——发布失败、空白画面、权限错误和平台特定问题。


---

# 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/unity-plugin-beta-overview/features.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.