> 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 角色提供由章节和触发器组成的结构化故事图。本节涵盖从理解运行时模型到完整脚本 API 的所有内容。

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>叙事设计如何工作</strong><br>了解运行时管线、章节、触发器、模板键和组件放置。</td><td><a href="/pages/8c61052d425664c56d66ff00e148451aeaa62bb1">/pages/8c61052d425664c56d66ff00e148451aeaa62bb1</a></td></tr><tr><td><strong>叙事设计快速入门</strong><br>为角色添加 Manager 和碰撞触发器，并在播放模式下确认章节切换。</td><td><a href="/pages/d4b9246d641fe591e1b8652c55ef5e59554dc6af">/pages/d4b9246d641fe591e1b8652c55ef5e59554dc6af</a></td></tr><tr><td><strong>配置叙事设计管理器</strong><br>添加、同步并配置 Manager 组件——用于监听章节切换的监听点。</td><td><a href="/pages/59d31b624a51d8790cd9e50732a32794dcfd69f1">/pages/59d31b624a51d8790cd9e50732a32794dcfd69f1</a></td></tr><tr><td><strong>配置叙事设计触发器</strong><br>通过碰撞、接近、计时器或手动激活来放置场景触发器。</td><td><a href="/pages/87ddb3e30dd1b009eb7bf39b583b5a654f486dbb">/pages/87ddb3e30dd1b009eb7bf39b583b5a654f486dbb</a></td></tr><tr><td><strong>配置叙事模板键</strong><br>从检查器或代码中将运行时值注入角色的叙事目标。</td><td><a href="/pages/630c1743293b81e62f2237b571dcf928c0d73285">/pages/630c1743293b81e62f2237b571dcf928c0d73285</a></td></tr><tr><td><strong>叙事设计脚本参考</strong><br>IConvaiNarrativeDesign、NarrativeDesignFetcher 以及程序化控制的完整 C# API 参考。</td><td><a href="/pages/e2aeb655628e9664d3a8c2993eb219a88fcfeef0">/pages/e2aeb655628e9664d3a8c2993eb219a88fcfeef0</a></td></tr><tr><td><strong>叙事设计使用示例</strong><br>四个完整示例，从简单的欢迎信息亭到完全自适应的多章节场景。</td><td><a href="/pages/5a4803abb898897932fbc643bd96c9e58ef4d96c">/pages/5a4803abb898897932fbc643bd96c9e58ef4d96c</a></td></tr><tr><td><strong>排查叙事设计问题</strong><br>诊断所有 TriggerStatus 状态、常见配置错误和获取失败。</td><td><a href="/pages/bd435d6564aabc01fda5fe6b7c130cf0ffeb1c36">/pages/bd435d6564aabc01fda5fe6b7c130cf0ffeb1c36</a></td></tr></tbody></table>


---

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