> 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/features/character-actions.md). # 角色动作查找 Convai 角色动作在 Unity 中的 Actions Editor、执行器参考、调度器配置、脚本 API 和使用指南。角色动作让 Convai 角色以场景内行为来响应玩家所说的话——走向目标、进行眼神接触、播放手势，或运行你自己的游戏代码。Convai 会识别要执行哪个动作以及目标是什么；Actions Editor 是你添加和配置 21 个内置执行器的地方，这些执行器负责实际执行，也可以接入你自己的执行器。本节涵盖从你的第一个动作到完整脚本 API 的所有内容。有几个内置执行器通过 Gaze 和 Body Animation 具现模块运行，因此角色在这些动作生效前需要安装相应的模块——请参见 [具身](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment.md).


角色动作如何工作了解流程、关键概念、所需组件和内置执行器。	角色动作的工作原理
角色动作快速入门从 Actions Editor 的入门目录中为你的 NPC 添加一个现成动作——无需脚本。	角色动作快速入门
Actions 编辑器 Actions Editor 窗口参考：Add Action 目录，以及一键配置执行器。	动作编辑器
配置角色动作完整参考： `ConvaiActionConfigSource` ——动作定义、目标以及连接时覆盖项。	配置角色动作
在运行时更新角色动作应用 `ConvaiActionConfigPatch` 在会话处于活动状态时，对动作、对象、角色和注意力的更新，并获得 Convai 的确认。	在运行时更新角色动作
动作执行器 21 个执行器组件的完整参考，并附 Inspector 字段表。	动作执行器
调度器和批处理策略配置如何 `ConvaiActionDispatcher` 处理并发批次和步骤失败。	分发器和批处理策略
编写自定义动作执行器实现 `IConvaiActionExecutor` 为任何动作创建项目特定行为。	编写自定义动作执行器
动作目标解析的工作方式命令中的目标词如何与场景中的真实对象匹配，以及注意力如何缩小匹配范围。	动作目标解析的工作方式
角色动作脚本参考涵盖所有动作系统类型、事件、枚举和组件的完整公共 API。	角色动作脚本参考
角色动作示例六个循序渐进的场景，从无需代码的 Inspector 设置，到脚本化批量注入、语音同步计时和观察动作。	角色动作示例
排查角色动作问题使用 Action Troubleshooter 和症状/原因/修复参考来诊断动作流程问题。	排查角色动作问题

--- # 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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/character-actions.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.