NarraLeaf-React 基础
学习 NarraLeaf-React 的核心创作流程:场景、动作、对话、选项、媒体、数据与偏好设置
基础教程适合在你已经拥有一个可运行的 NarraLeaf-React 项目后阅读。它会带你完成故事编写的主要流程:定义场景、添加动作、显示对话和图片、连接故事段落,然后逐步加入交互、音频、数据、语音和玩家偏好设置
本节示例对应 NarraLeaf React 0.39.2 和 React 19。旧项目中可能仍有已经移除的 Sound.sync,或写在 GameConfig 中的对话字体默认值
前置准备
开始本节之前,请先创建或准备一个 NarraLeaf-React 项目:
核心流程
教程列表
创建场景
定义故事结构和视觉上下文的基本单位
添加动作
构建驱动场景播放的有序动作列表
显示对话
显示角色台词和旁白内容
显示图片
在场景中放置视觉素材
播放故事
将场景连接到播放器并运行故事
制作选项
让玩家在不同分支之间做出选择
声音
添加音频提示和播放行为
存储数据
保存会影响后续故事事件的值
条件
只在当前游戏状态匹配时执行动作
语音
为故事呈现绑定语音播放
管理偏好
提供并更新面向玩家的设置
下一步
完成基础教程后,可以阅读解决方案学习完整模式,阅读核心了解底层故事 API,或阅读播放器了解负责渲染体验的 React 组件与 Hook
0.13 项目可以重点查看显示图片中的层叠立绘,以及声音中使用 Control.doAsync() 实现非阻塞音效的写法