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

# 功能

- [Actions](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/actions.md): 让 AI 角色具备根据玩家所说内容采取行动的能力。涵盖完整的动作系统——架构、配置、执行器和运行时控制。
- [快速开始](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/actions/quick-start.md): 从添加组件到在播放模式中测试实时命令，逐步演示你的第一个可用 Convai Action。
- [配置动作](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/actions/configuring-actions.md): 定义可用动作，将场景对象和角色注册为目标，并使用 ConvaiActionConfigSource 配置执行器绑定。
- [动作执行器](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): 诊断最常见的动态上下文问题——从角色忽略上下文更新到会话重置后的意外行为。
- [情绪](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 角色对实时对话产生情绪反应。
- [Emotion Profile](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/emotion/emotion-profile.md): 将所有可配置参数集中在一处——表情如何快速上升和消退，微脉冲如何增加自然感，以及中性轮换如何防止面部僵住。
- [Output Bindings](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features/emotion/output-bindings.md): 将每种情绪映射到角色骨架上的特定面部形状或 Animator 参数，并为每个槽位设置权重和 LipSync 协调。
- [Emotion Taxonomy](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 错误，并借助内置诊断工具在运行时验证已存储的记忆。
- [Narrative Design](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 为先的设置流程——管理器、触发器和碰撞区域——追踪从玩家交互到 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 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): 叙事设计的完整 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 状态、常见 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 编辑器中验证 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:

```
GET https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin-beta-overview/features.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.