Game.background

背景控制模块，支持图片、视频和滤镜效果。

API 概览

方法	描述
`img(url, options?)`	设置图片背景
`video(url, options?)`	设置视频背景
`empty()`	清空背景
`filter(type, options?)`	添加滤镜效果

img()

设置图片背景。


// 基础用法
Game.background.img("/backgrounds/bg.webp");
 
// 带过渡效果
Game.background.img("/backgrounds/bg-classroom.png", {
  transition: { transition: "fade", duration: 1 }
});
 
// 指定位置模式
Game.background.img("/backgrounds/bg.png", {
  position: "cover"  // 'cover' | 'contain' | 'center'
});

video()

设置视频背景。


Game.background.video("/backgrounds/intro.mp4", {
  transition: { transition: "fade", duration: 1 },
  loop: true,      // 循环播放，默认 true
  volume: 0        // 视频音量 (0-1)，默认 0
});

empty()

清空当前背景。


Game.background.empty();

filter()

为背景添加滤镜效果。


// 模糊滤镜
Game.background.filter("blur", { intensity: 10 });
 
// 亮度调节
Game.background.filter("brightness", { value: 1.2 });
 
// 对比度调节
Game.background.filter("contrast", { value: 1.5 });
 
// 清除滤镜
Game.background.filter("none");

滤镜类型

类型	参数	描述
`none`	-	无滤镜
`blur`	`intensity`	模糊程度
`brightness`	`value`	亮度值
`contrast`	`value`	对比度值

过渡效果

类型	描述
`none`	无过渡，立即切换
`fade`	渐变过渡
`blur`	模糊过渡


Game.background.img("/bg.png", {
  transition: {
    transition: "fade",  // 'none' | 'fade' | 'blur'
    duration: 1          // 过渡时间（秒）
  }
});

与其他操作并行


// 背景切换和旁白同时进行
Game.background.img("/backgrounds/bg.webp");
Game.parallel();
Game.narrate`场景切换...`;

存档恢复

背景和滤镜状态会自动保存和恢复：

保存时记录当前背景和滤镜配置
恢复时直接显示（无过渡动画）