为角色添加叙事设计

按照本指南将叙事设计融入您的 Convai 驱动角色。跟随这一步一步教程，打开您的项目，我们开始吧！

Convai Playground

步骤1：选择你想启用叙事设计的角色

在此演示中，我们使用 Seraphine Whisperwind，你可以选择任何你想启用叙事设计的角色。

显示选择角色的截图 Convai Playground

步骤2：在 Convai Playground 中打开叙事设计

从侧边栏中选择叙事设计选项并创建你的叙事设计

显示叙事设计图标的截图

有关如何在 Convai Playground 中创建叙事设计的更多信息，请参考以下 YouTube 视频系列

展示如何创建叙事设计的视频系列

对于此示例，我们创建了以下叙事设计

你已经准备好将你的角色从 Convai Playground 带到 Unity 了，让我们前往 Unity 继续本指南

Unity 设置

步骤1：添加叙事设计管理器组件

使用 添加组件 Convai NPC 中的按钮（推荐方式）

1: 在场景中选择你的 Convai 角色，并在检查器面板中找到 ConvaiNPC 组件。点击 添加组件 按钮

显示……位置的截图 添加组件 Convai NPC 检查器面板中的按钮

2: 选择 叙事设计管理器 复选框，然后点击 应用更改 按钮

显示在添加组件窗口中选择叙事设计选项的截图

使用 Unity 检查器

1: 选择你的 Convai 角色，并在检查器面板中找到“添加组件”按钮

显示检查器面板中“添加组件”按钮位置的截图

2：搜索 叙事设计管理器 ，在搜索框中并选择它

显示应从搜索结果中选择哪个组件的截图

步骤2：设置叙事设计组件

添加叙事设计组件后，你将能够看到以下组件

此组件系统假定 API 密钥已正确设置，因此请确保 API 密钥已正确设置，否则会抛出错误。

添加后，组件将根据从 ConvaiNPC 获取的角色 ID 检索各章节，请根据你的网络速度等待一段时间。

以下章节事件适用于演示中使用的角色，你将看到与你启用叙事设计的角色相对应的章节事件。

显示示例叙事设计组件的截图

了解叙事设计组件

展开章节事件后，你会看到两个可订阅的 Unity 事件，一个在章节开始时触发，另一个在章节结束时触发

显示用户可订阅的各种 Unity 事件的截图

了解章节触发器

章节触发器是一种直接调用叙事设计中某个章节的方式，可用于跳转到叙事设计中的其他章节

步骤1：选择你想要作为触发器的游戏对象，在这个示例中我们选择了一个简单的立方体，但这取决于你的想象力。

确保你决定作为触发器的游戏对象附带一个碰撞体

显示已选中带有碰撞体的游戏对象的截图

步骤2：通过搜索在“添加组件”菜单中添加叙事设计触发器

显示选择叙事设计触发器的截图

步骤3：将碰撞体设为触发器。

显示 Box Collider 变为触发框的截图

步骤4：将你的 Convai NPC 分配到 Convai NPC 字段

显示将 Convai NPC 分配给触发器组件的截图

现在你可以在“Trigger”下拉菜单中选择当玩家进入此触发框时应调用哪个触发器。

我们还为你添加了一种手动调用此触发器的方法，你可以使用 InvokeSelectedTrigger 函数从任何地方调用该触发器

显示可选择你所需触发器的截图

从任何脚本中调用触发器

你可以将此代码块作为参考，从任何地方调用触发器

if(convaiNPC.TryGetComponent(out NarrativeDesignTrigger narrativeDesignTrigger))
{
    //可选消息参数，如果你在调用时想发送一些消息
    //该触发器 
    string message = "玩家已收集到足够的资源";
    narrativeDesignTrigger.InvokeSelectedTrigger(message);
}