Electron:实现舞台背景媒体选择与播放

Author: link-1069Created Aug 17, 2026Updated Aug 17, 2026

Parent

#430

What to build

让用户从两种呈现模式的右键菜单管理全屏舞台背景,选择并验证本地图片、GIF 或 MP4,并在舞台中以一致规则呈现。

Acceptance criteria

  • 舞台背景菜单提供透明背景、使用已选媒体、选择本地媒体和清除已选媒体。
  • Windows 文件选择器仅接受 PNG、JPG/JPEG、WebP、BMP、GIF 和 MP4,并只保存原始绝对路径,不复制文件。
  • 新文件成功解码后才提交;选择取消不改变状态;主动验证失败保留旧背景并显示模态错误。
  • 背景类型与已选媒体路径分别保存;透明状态选择文件只更新路径,媒体状态选择文件会验证后立即替换画面。
  • 主动切换透明会保留路径;确认清除会切换透明并删除路径。
  • 图片、GIF 和 MP4 都保持比例、居中并使用 cover 铺满舞台。
  • MP4 自动播放、静音、循环且无控件;离开全屏或临时预览后停止媒体并释放渲染资源,再次进入时从头播放。
  • 桌宠模式可以配置舞台背景但不自动打开全屏预览。
  • 行为测试覆盖文件过滤、验证事务、背景状态切换、cover 几何、MP4 生命周期和资源释放。

Blocked by

  • #432 — Electron:实现桌面宠物与全屏舞台模式切换

Source: Open-LLM-VTuber/Open-LLM-VTuber