引.故事 是什么？

引.故事 是一个非线性故事编辑器，主要以树形结构（类脑图）构建开放性故事的不同剧情分支，以提供良好的剧情可视化。

快速开始

在 引.故事 中，您所需要创建的主要有两大类内容：场景 和 事件。 一个场景可包含多个事件，事件激活时指向下一个场景。

场景

用以展示当前剧情，用户可以在场景中设置：

• 媒体：背景视频、图片、背景音
• 事件：该剧情可触发的事件
• 封面：为故事脉络中的可再入节点创建可点击的封面

以上为场景所包含的基础设置，同时，系统内置了多种不同的场景：

场景	说明
基础场景	通用的剧情展示场景
通讯场景	仿制聊天应用，支持 12 种消息类型
文本场景	全屏滚动的字幕
对话场景	对话框聊天，支持打字机效果和旁白音频
场景组	编组多个场景，切换时保留播放状态，实现无感过渡

场景组

场景组允许您将多个场景编组，在场景之间切换时保留 播放进度 和 播放状态，用于实现连续场景之间的无缝过渡。

事件

用以手动或自动激活场景中发生的情况，以进入对应的新场景，事件主要以按钮的形式呈现，内置的事件有：

事件	触发方式	说明
文字按钮	点击	带文字的按钮，支持丰富的样式预设
媒体按钮	点击	以图片/视频为主体的按钮
进度条	交互	支持点击/长按/自动流逝的进度条
自动事件	场景结束	场景播放结束后自动触发
后退事件	点击/手柄	沿故事路径回退到之前的场景

后退事件

根据设定自动回退到故事路径中之前的场景。支持跳转数量设定（设为 -1 时自动绑定手柄 B 键），按钮样式可完全自定义。

提示（Tip）

场景中可以弹出文字或媒体提示，用于展示额外信息而不切换场景：

• 文字提示：弹出带背景图的富文本，支持自定义样式
• 媒体提示：全屏展示图片或视频

通讯场景消息类型

通讯场景内置了丰富的消息类型来模拟真实的聊天体验：

类型	说明
文本消息	普通聊天文字
可选消息	用户选择不同回复，支持后续消息链或跳转场景
通知消息	系统通知样式
转账消息	带金额、单位、说明，自动匹配收款状态
媒体消息	图片/视频，点击全屏查看
语音消息	音频播放条
文件消息	图标 + 文件名 + 大小 + 预览
表情消息	透明 webm 贴纸
链接消息	带缩略图、标题，可跳转场景
事件消息	可选消息中的可激活事件节点

媒体对象

场景中的媒体支持丰富的控制选项：

• 视图：视频或图片作为背景
• 音频：配合图片的音频播放
• 背景音频：跨场景延续的背景音乐
• 媒体适应：填充、适应、拉伸、居中、缩放五种显示模式
• 循环播放：设定循环开始时间，在指定区间循环
• 播放完成时间：精确控制事件出现的时机
• 持续时间：纯图片场景的持续时长

事件排版

每个场景可独立设置事件按钮的排版方式：

• 版式：横向 / 横向反向 / 竖向 / 竖向反向
• 布局：起点、终点、居中、两端、环绕、均匀、拉伸
• 对齐：起点、终点、居中、拉伸、基线
• 边距：四方向限定排版区域
• 占位校准：忽略按钮实际大小，按点排布

排版默认由主题全局控制，也可在单个场景中覆盖。

事件样式

每个按钮事件支持四层样式设定：

• 常态样式：基础 CSS，支持过渡动画
• 悬浮样式：鼠标悬浮时触发
• 入場样式：按钮出现时的动画（Animate.css）
• 出場样式：按钮消失时的动画

多事件同时入場时自动延迟 150ms 序列式展示。

主题系统

主题系统提供了全局的视觉一致性：

• 事件主题：统一管理事件的排版、文字按钮预设、媒体按钮预设
• 场景主题：统一管理场景的排版预设、通讯应用预设、对话框预设、文本场景预设
• 自定义字体：导入字体文件，在样式中通过 FontFamily 调用

封面系统

为场景节点创建可点击的封面，支持：

• 主体媒体：图片或视频封面
• 悬浮覆盖：鼠标悬浮时的透明贴纸层
• 悬浮隐藏：悬浮时隐藏主体

手柄支持

编辑器、故事浏览器和网页均支持手柄操作，支持完整的按钮映射和轴映射，以及跨场景自动焦点切换。

存档编辑器

故事播放页内置 JSON 存档编辑器，可直接查看和修改存档数据。

编辑器

引.故事 编辑器通过 引.Object 构建，借助其热更新的特性，您在编辑器对数据的改动将实时更新在故事中， 故而建议您自行并排放置编辑器和故事窗口以获得更好的编辑体验。

开始编辑

若您不需要在故事中添加诸如类似 不同好感度导向不同剧情 这样的逻辑判断事件，则无需了解本文档的后续内容 脚本。