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