> 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——从添加组件到在播放模式下测试实时命令。
- [配置 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): 通过 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): 一步步带你完成第一个可用的 Dynamic Context 集成——一个知道玩家站在哪里的角色，只需点击一个按钮即可更新。
- [命令组件参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/dynamic-context/command-component-reference.md): Dynamic Context Command 组件上的每个字段、命令类型和事件——通过 Unity Inspector 驱动角色感知的完整参考。
- [连接时的静态上下文](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): Dynamic Context 脚本接口上每个方法、参数和返回值的完整参考——面向从游戏代码驱动角色感知的开发者。
- [同步行为与时序](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): 诊断最常见的 Dynamic Context 问题——从角色忽略上下文更新到会话重置后的异常行为。
- [情绪](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/emotion.md): 了解 Emotion 系统的工作方式、每个组件的作用，以及下一步该去哪里——这是为任何 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): 通过实际场景展示 Emotion 系统的运行：危险响应、脚本化问候、适应性分支、分析和创作流程。
- [故障排查与诊断](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/emotion/troubleshooting-and-diagnostics.md): 针对最常见的 Emotion 系统问题提供逐步修复方案——从表情不动到 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 Editor 验证跨会话回忆。
- [终端用户身份](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): 使用 Configuration Window 或 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): 完整演示 Inspector 优先的设置流程——Manager、Trigger 和碰撞区域——并跟踪从玩家交互到在播放模式中确认章节变化的完整信号路径。
- [设置叙事设计管理器](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 Events、全局切换回调，以及确认仪表板返回内容的同步状态字段。
- [设置叙事设计触发器](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 Events。
- [模板键：动态叙事变量](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): 通过键值对将运行时值注入角色的叙事目标中——可从 Inspector 或代码中设置——并在会话打开和重连时自动传递。
- [叙事设计脚本编程](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/narrative-design/scripting-narrative-design.md): Narrative Design 的完整 C# 接口——IConvaiNarrativeDesign 事件、InvokeTrigger、带 speak tags 的 InvokeSpeech、异步章节获取，以及运行时触发器重新配置。
- [使用示例](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/narrative-design/usage-examples.md): 四个复杂度递增的示例——从单触发欢迎序列到自适应多章节场景——展示如何在实践中组合 Narrative Design 组件。
- [故障排查与诊断](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 状态、常见 Inspector 配置错误、获取失败和队列超时问题。
- [视觉](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 可用设置路径。从 Inspector 中添加帧源和发布器，验证流，并了解运行时会发生什么。
- [帧源](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/vision/frame-sources.md): 为你的平台选择并配置合适的帧源。涵盖所有 Inspector 字段、捕获预设、平台要求和源状态诊断。
- [发布与策略](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 Editor 中通过实时覆盖层验证 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.