> For the complete documentation index, see [llms.txt](https://docs.convai.com/api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/overview/feature-map.md).

# 功能地图

当你知道自己想要的结果，但不确定哪个 SDK 功能、模块或指南涵盖它时，请使用此表。

### 入门

| 我想……               | 功能 / 工具  | 文档                                                                                                                  |
| ------------------ | -------- | ------------------------------------------------------------------------------------------------------------------- |
| 将 SDK 安装到我的项目中     | 安装       | [安装](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/getting-started/installation.md)                            |
| 配置我的 Convai API 密钥 | API 密钥设置 | [配置 API 密钥](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/getting-started/configure-api-key.md)                |
| 将我的第一个对话角色添加到场景中   | 场景设置     | [构建自定义场景](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/getting-started/build-a-custom-scene.md)               |
| 无需从头构建即可运行一个可用示例   | 示例场景     | [导入并运行示例场景](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/getting-started/import-and-run-sample-scenes.md)     |
| 了解场景中每个组件的作用       | 组件参考     | [场景组件参考](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/getting-started/scene-components.md)                    |
| 在按住说话和免提输入之间选择     | 输入模式     | [配置对话输入模式](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/getting-started/configure-conversation-input-mode.md) |
| 配置角色音频输出           | 音频设置     | [配置角色音频](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/getting-started/configure-character-audio.md)           |
| 配置麦克风设备和平台权限       | 音频设置     | [配置麦克风](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/getting-started/configure-microphone.md)                 |
| 添加聊天或字幕转录显示        | 转录 UI    | [添加聊天 UI](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/getting-started/add-chat-ui.md)                        |
| 为我的角色添加实时口型同步      | 口型同步     | [添加口型同步](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/getting-started/add-lip-sync.md)                        |
| 在发布前验证我的场景是否设置正确   | 场景验证器    | [验证你的设置](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/getting-started/validate-your-setup.md)                 |

### 功能

| 我想……                        | 功能    | 文档                                                                                      |
| --------------------------- | ----- | --------------------------------------------------------------------------------------- |
| 让我的角色执行场景内命令（触发动画、打开门、移动物体） | 动作    | [动作](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/character-actions.md)  |
| 将运行时状态或事件注入角色的知识中           | 动态上下文 | [动态上下文](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/dynamic-context.md) |
| 让角色自动读取有关场景对象的信息            | 场景元数据 | [场景元数据](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/scene-metadata.md)  |
| 根据 AI 响应在我的角色上显示面部情绪        | 情绪    | [情绪](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/emotion.md)            |
| 让角色在不同会话之间记住玩家              | 长期记忆  | [长期记忆](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/long-term-memory.md) |
| 构建由对话触发的分支式故事片段             | 叙事设计  | [叙事设计](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/narrative-design.md) |
| 通过摄像头或网络摄像头让我的角色获得视觉能力      | 视觉    | [视觉](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/vision.md)             |

### 实用工具

| 我想……             | 实用工具   | 文档                                                                                           |
| ---------------- | ------ | -------------------------------------------------------------------------------------------- |
| 为我的角色添加身体和头部对话动画 | 对话动画   | [对话动画](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/utilities/dialogue-animation.md)   |
| 让我的角色看向目标、玩家或兴趣点 | 注视与注意力 | [注视与注意力](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/utilities/gaze-and-attention.md) |

### UI 与呈现

| 我想……                    | 组件     | 文档                                                                                                                                  |
| ----------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------- |
| 在我的 UI 中显示实时对话记录        | 转录 UI  | [转录 UI](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/ui-and-presentation/transcript-ui.md)                                    |
| 在聊天和字幕显示模式之间切换          | 呈现模式   | [聊天和字幕模式](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/ui-and-presentation/transcript-ui/chat-and-subtitle-modes.md)          |
| 从代码中查询对话记录历史或响应对话记录变化   | 对话记录历史 | [对话记录历史与查询](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/ui-and-presentation/transcript-ui/transcript-history-and-queries.md) |
| 显示游戏世界内通知弹窗             | 通知系统   | [通知系统](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/ui-and-presentation/notification-system.md)                               |
| 添加运行时设置面板（麦克风、转录、通知、输入） | 设置面板   | [设置面板](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/ui-and-presentation/settings-panel.md)                                    |
| 从代码中读取或应用运行时设置          | 运行时设置  | [运行时设置 API](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/ui-and-presentation/settings-panel/runtime-settings-api.md)          |
| 自定义 UI 组件的外观和布局         | UI 自定义 | [自定义 UI 组件](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/ui-and-presentation/customizing-ui-components.md)                    |

### 核心概念

| 我想……                    | 概念     | 文档                                                                                                                  |
| ----------------------- | ------ | ------------------------------------------------------------------------------------------------------------------- |
| 全面了解系统架构                | 架构     | [Convai Unity SDK 架构](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/overview/convai-unity-sdk-architecture.md) |
| 了解会话状态、重连和持久化           | 会话生命周期 | [会话生命周期](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/core-concepts/session-lifecycle.md)                     |
| 比较免提和按住说话的轮流发言方式        | 轮流发言模式 | [轮流发言模式](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/core-concepts/turn-taking-modes.md)                     |
| 从 C# 或 Inspector 订阅对话事件 | 事件系统   | [事件系统](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/core-concepts/event-system.md)                            |

### 脚本参考

| 我想……                                | API      | 文档                                                                                                               |
| ----------------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------- |
| 订阅会话连接 / 断开连接 / 错误事件                | 会话事件     | [会话事件](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/scripting-reference/session-events.md)                 |
| 订阅转录、情绪和轮次事件                        | 角色事件     | [角色事件](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/scripting-reference/character-events.md)               |
| 在运行时读取并清空对话记录历史                     | 对话记录 API | [对话记录 API](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/scripting-reference/transcript-api.md)             |
| 使用 `ConvaiSDK` 和 `ConvaiAudio` 静态门面 | 对话门面     | [ConvaiManager API](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/scripting-reference/convaimanager-api.md) |
| 了解 `IConvaiOperation<T>` 以及异步模式     | 异步模式     | [异步模式](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/scripting-reference/async-patterns.md)                 |

### 平台指南

| 我想……                 | 平台              | 文档                                                                                                           |
| -------------------- | --------------- | ------------------------------------------------------------------------------------------------------------ |
| 使用 WebGL 发布到浏览器      | WebGL           | [WebGL](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/platform-guides/webgl.md)                         |
| 发布到 Android 或 iOS    | 移动端             | [移动端 — iOS 和 Android](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/platform-guides/ios-and-android.md) |
| 使用透视视觉发布到 Meta Quest | Meta Quest / XR | [Meta Quest 和 XR](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/platform-guides/xr-headsets.md)         |

### 高级主题

| 我想……                  | 主题      | 文档                                                                                                                               |
| --------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------- |
| 替换 API 凭证提供程序         | 自定义提供程序 | [自定义凭证提供程序](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/advanced-topics/custom-providers/custom-credential-provider.md)   |
| 替换终端用户身份提供程序          | 自定义提供程序 | [自定义身份提供程序](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/advanced-topics/custom-providers/custom-identity-provider.md)     |
| 替换会话持久化提供程序           | 自定义提供程序 | [自定义持久化提供程序](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/advanced-topics/custom-providers/custom-persistence-provider.md) |
| 测量延迟并解读会话指标           | 性能      | [性能与优化](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/advanced-topics/performance-and-optimization.md)                      |
| 使用自定义模块扩展 SDK 或替换内部服务 | 扩展点     | [扩展 SDK](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/advanced-topics/extending-the-sdk.md)                                |

### 下一步

如果你尚未设置 SDK，请从安装开始。

{% content-ref url="/pages/5ea68df21c8a54f95779af92056a9ab831531be5" %}
[快速上手](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/getting-started.md)
{% endcontent-ref %}


---

# 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/convai-unity-sdk/overview/feature-map.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.