> 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, and the optional `goal` query parameter:

```
GET https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/narrative-design.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.