WebGAL 技术介绍
WebGAL 技术介绍
场景系统与预加载
场景获取
WebGAL 的场景是以文件为单位的，一般来说是后缀名为.txt的WebGAL 脚本文件。就像很多编程语言有一个 main函数作为入口一样，WebGAL 的入口场景是start.txt。WebGAL 会首先尝试获取 start.txt，然后调用WebGAL 解析器将脚本文件解析为 WebGAL 引擎可以执行的场景对象。在任何一个场景中，都可以使用choose、changeScene、callScene这样的方式切换或“调用”场景。切换场景会直接替换当前的场景，而“调用”场景则会向场景调用栈中推入一个新的场景开始执行，并在执行后回到调用该场景的父场景。
预加载场景中的资源
在 WebGAL 解析场景的同时，场景所包含的资源也会被解析出来。对于每个场景文件，WebGAL 都会将其包含的所有资源，包括图片、音频以及视频文件。这些文件会在场景被解析完后开始预加载，以尽可能减少用户在游戏流程中等待资源加载的可能性。同时，为了使游戏在切换场景时更为顺畅，WebGAL 也会加载被当前的场景文件引用的场景文件的资源。为了防止资源浪费，WebGAL 只会拓展一层场景做预加载。
WebGAL 解析器
语句解析 Ⅰ 拆分场景
WebGAL 场景文件主要是以行来区分脚本的。在解析的一开始，WebGAL 解析器就会按照换行符将脚本分割开。如果有分号，则会取分号前的字符。所以，WebGAL 脚本的注释方式就是将脚本写在分号后。
语句解析 Ⅱ 脚本类型解析
WebGAL 的脚本一般是形如
command:content -arg1 -arg2 ......;comment
的形式。
其中，command 代表语句指令，比如 bgm、changeFigure、choose这样的指令，用于标明该语句对应的控制动作。而 content则代表语句的主要内容，比如 bgm:Teabreak.mp3表示的是播放一段音频文件作为 bgm。
语句解析 Ⅲ 对话的特殊处理
WebGAL 的对话一般以如下形式书写：
森川由绮:胸につかえていることを、时は解决してくれない。忘却のラベルを贴るだけで -voice_1.ogg;
对于视觉小说来说，由于对话一般是脚本的主要组成部分，所以 WebGAL 设计了一个语法糖。如果任何一个脚本的 command 部分无法被解析为任何一种指令，那么 WebGAL 就会将其视为对话。而语音也可以简写其参数，只需要给出文件名即可。如上的对话实际上最终会被解析成 say 指令。
所以，这段对话的真正表示应该为：
say:胸につかえていることを、时は解决してくれない。忘却のラベルを贴るだけで -speaker=森川由绮 vocal=voice_1.ogg;
除此以外，如果对话由一个人物发出，那么在对话人发生改变前，还可以省略人物名称：
森川由绮:胸につかえていることを;
时は解决してくれない;
忘却のラベルを贴るだけで;
对于对话的特殊处理大大提高了脚本编写的效率。
语句解析 Ⅳ 参数解析
在 content 后以 -分隔的是附加参数。格外需要注意的是，附加参数的连字符-前需要有空格，否则 WebGAL 可能会认为这不是一个参数而是一个正常的连字符。
WebGAL 的参数是以 -key=value的形式表示的，其中，key 的类型为string，而value的类型则可以动态决定，并可以以下三种可能的类型存在： string、number、boolean。
比如 -key=s的value是 string；-key=1的value是number，-key=true或-key=false的value是boolean。
其中，只写出 key而省略value的参数会被解析成 -key=true，这是一个简写的语法糖。这个语法糖非常重要，因为WebGAL 中有一个重要参数 -next，用于表示在执行完当前语句后立刻执行下一条语句。如果没有省略表示，则每次都需要书写-next=true。
语句解析 Ⅴ 资源处理与预加载
在进行语句解析的时候，就可以获得语句所需要的资源了。比如，bgm语句一般需要音频资源，playVideo语句一般需要视频资源，changeBg语句一般需要图片资源。WebGAL 场景解析器会将所有场景中语句需要的资源合并起来，用于交给预加载器来预加载资源。同时，当遇到形如changeScene、choose、callScene等需要调用子场景的情况时，子场景也会被扫描出，解析并对其中的资源进行预加载。
流程控制系统
准备阶段：步进前操作
流程控制模块从场景指令存储模块（这个模块是场景管理模块的子模块）获取一条指令，并进行步进前操作和检查。步进前操作主要包括停止在上一个流程中没有结束的动画、视频等带有持续时间的视觉效果。这个操作是因为当用户在上一个流程还没有结束时就点击鼠标或按下键盘的指定快捷键，意味着用户可能并不想等待到这个流程在抵达持续时间后正常结束，而是想跳过这个流程。这个时候，流程控制系统就会调用对应的提前停止流程函数（每个视觉效果都需要提供一个用于卸载这个效果的函数，调用这个函数将完全卸载这个视觉效果）。而检查则主要包括检查是否存在不能被跳过的视觉效果和检查是否已经到达当前场景的最后一条语句。如果存在不能被跳过的视觉效果（部分视觉效果脚本由于其特殊性，不能被跳过，由文章维护人员设置），则用户必须等待到抵达持续时间结束后，才可以进入下一个流程。而如果当前已经抵达场景的最后一条语句，流程控制模块会检查场景调用栈是否为空，如果不为空，则将栈顶的元素（一个场景对象）替换当前的场景存储模块中存储的场景，并将“当前语句”的指针指向场景的第一条语句，随后执行这一条语句。而如果场景调用栈为空，则可以视为互动阅读流程已经结束，这时候引擎将会跳转回互动阅读的主界面。
正式阶段 Ⅰ：读指令、执行条件判断
在这个阶段，指令将会被读取并进行条件判断。由于每一条指令都可能包含描述执行条件的参数（when参数），所以在每次执行指令时，都要进行条件判断。此时流程控制模块将描述执行条件的参数送到变量与条件判断模块请求条件判断。条件判断模块会解析条件判断表达式，结合引擎存储的内部变量进行条件判断，最终返回一个条件判断结果（真或假）。流程控制模块根据这个结果判断这条指令要不要执行。如果不执行，则跳过接下来的所有流程中的步骤，并重新回到准备阶段，准备读取下一条指令。
如果条件判断给出了真的结果，则流程控制模块进入正式阶段II。
正式阶段 Ⅱ：调用、获取演出控制模块送演出控制器
在这个阶段，将正式执行语句的指令所要执行的动作。每一种类型的指令都对应这一种动作，这个动作被存储在指令配置和执行模块。在指令配置和执行模块中，存有指令所对应的动作的配置。动作的配置主要包括指令需要执行哪些状态修改的操作（比如修改“舞台”背景或切换某个位置的人物图像）、哪些动画或特殊效果操作（比如为背景或人物图像添加一段动画效果或启动一段下雨或下雪的特殊效果）、播放一段多媒体资源等。这个配置会被送入指令执行器，具体地被指令执行器执行对应的动作。每个指令执行器执行指定的动作后，都会返回一个“演出控制模块”，这里的“演出”所表示的就是一个具有持续时间的视觉效果。“演出控制模块”主要描述当前流程中正在执行的视觉效果的描述信息和用于卸载这个视觉效果的函数，这个函数会在视觉效果抵达持续时间后被自动调用，或者在用户提前发出指令中断后提前调用。这个模块会被送入“演出控制器”，这个控制器负责维护“演出控制模块”，包括在持续时间抵达后自动卸载“演出”和在用户操作后被处于准备阶段的流程控制器调用提前结束“演出”的方法。
结束阶段：处理连续演出、更新 Backlog
在指令执行结束后，进入结束阶段。在这个阶段，主要处理阅读历史记录的维护。因为我们需要在阅读的过程中记录用户阅读的历史记录，以方便用户在任何时候都可以查看自己的阅读历史，并回到某个记录节点。在传统的纸质图书或图文混排的阅读方式中，用户通常以往回翻页或向上滚动鼠标滚轮的方式来回到一个之前阅读的位置。而互动阅读由于阅读的流程可能会随着用户操作而改变，因此不能使用传统的记录方式（记录页码或滚动位置等）。因此，在每个结束阶段，流程控制模块都会记录当前阅读位置（一般来说是某个场景的第n条指令），以及当前的变量信息和场景状态信息。这样，当用户想要回到过去阅读的某个记录节点时，就可以很方便地读取并恢复到之前阅读的位置。
自动与快进
自动阅读和快进系统本质上就是在指定的间隔内试图代替用户执行步进。自动和快进的主要区别在于，其发出的指令的优先程度和间隔不一样。
自动模式下，每隔一段时间（取决于自动模式被设置的速度），就会发出指令给流程控制系统，要求“步进”。自动模式的优先级较低，所以当遇到阻塞自动的演出（绝大多数演出，比如视频播放、对话、动画等都是阻塞自动模式的演出）时，将不会执行，直到没有演出阻塞自动模式。
而在快进模式下，绝大多数演出会被跳过，只有像选择支这样的必须用户执行一些操作的演出，不会被跳过。快进模式的触发间隔也明显较短。