> 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/narrative-design.md). # 叙事设计查找在 Convai Unity SDK 中设置、配置、脚本编写和排查 Narrative Design 系统的指南。叙事设计为 Convai 角色提供了一个由章节和触发器组成的结构化故事图。本节涵盖从理解运行时模型到完整脚本 API 的所有内容。


叙事设计的工作原理了解运行时流程、章节、触发器、模板键以及组件放置。	叙事设计的工作原理
叙事设计快速入门向角色添加管理器和碰撞触发器，并在播放模式中确认章节切换。	叙事设计快速开始
配置叙事设计管理器添加、同步并配置 Manager 组件——用于监听章节切换。	配置叙事设计管理器
配置叙事设计触发器放置具有碰撞、接近、计时器或手动激活的世界触发器。	配置叙事设计触发器
配置叙事模板键通过检查器或代码将运行时值注入角色的叙事目标。	配置叙事模板键
叙事设计脚本参考 IConvaiNarrativeDesign、NarrativeDesignFetcher 以及程序化控制的完整 C# API 参考。	叙事设计脚本参考
叙事设计使用示例四个实战示例，从简单的欢迎柜台到完全自适应的多章节场景。	叙事设计使用示例
叙事设计故障排查诊断每一种 TriggerStatus 状态、常见错误配置和获取失败。	排查叙事设计问题

--- # 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/narrative-design.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.