背景转场教程 - Shiori 引擎

← 返回主页

功能说明： 通过在 background 字段中添加关键词，您可以轻松实现多种场景切换效果。

1. 基础语法结构

背景指令位于剧情行的 background 属性中。

直接切换： background: "bg_id"（无动画，瞬间切换）
带动画切换： 在背景 ID 前添加转场关键词和空格，例如 "fade bg_001"。
自动清理： 转场过程中会自动隐藏所有活跃立绘，确保画面整洁。

2. 淡入淡出 (Fade)

最经典的转场方式，画面逐渐变黑并切换到新场景。

中文	英文	说明
转场	trans / fade	标准淡入淡出效果

// 使用英文关键词
{ background: "fade bg_001_00_00" }

// 使用中文关键词
{ background: "转场 bg_001_00_00" }

3. 滑动转场 (Slide)

模拟镜头平移的效果，旧背景向一侧移出，新背景从另一侧滑入。

中文	英文	效果描述
左滑	slideL	新背景从左侧滑入，旧背景向右侧移出
右滑	slideR	新背景从右侧滑入，旧背景向左侧移出

// 左滑进入
{ background: "slideL bg_002_00_00" }
{ background: "左滑 bg_002_00_00" }

// 右滑进入
{ background: "slideR bg_003_00_00" }
{ background: "右滑 bg_003_00_00" }

4. 扫描转场 (Scan)

一种更具视觉冲击力的覆盖效果，新背景像扫描线一样逐步覆盖旧背景。

中文	英文	效果描述
左转场	scanL	从左向右扫描覆盖
右转场	scanR	从右向左扫描覆盖

// 从左向右扫描
{ background: "scanL bg_004_00_00" }
{ background: "左转场 bg_004_00_00" }

// 从右向左扫描
{ background: "scanR bg_005_00_00" }
{ background: "右转场 bg_005_00_00" }

5. 组合使用示例

在实际剧本中，转场通常伴随着文本和立绘的变化。

story: [
    { 
        text: "故事发生在繁华的都市...", 
        speaker: "旁白",
        background: "bg_city_day"
    },
    { 
        text: "随着夜幕降临，城市换上了另一副面孔。", 
        speaker: "旁白",
        // 执行淡入淡出转场到夜景
        background: "trans bg_city_night" 
    },
    { 
        text: "突然，一阵风吹过。", 
        speaker: "主角",
        // 执行左滑转场到街道场景
        background: "slideL bg_street"
    },
    { 
        text: "我们来到了一个陌生的地方。", 
        speaker: "配角",
        // 执行扫描转场
        background: "scanR bg_unknown"
    }
]

6. 注意事项

重要提示：
1. 自动清理： 所有转场指令在执行时都会自动调用 [消失 all]。
2. 持续时间： 目前转场动画默认持续时间为 1 秒（1000ms）。
3. 资源预加载： 建议在 sceneData.background 中预先定义好所有背景图片的路径。
4. 中英文兼容： 所有转场关键词均支持中英文别名，可根据个人习惯混用。