feat: playback bar component, save system improvements, demo and roadmap updates

This commit is contained in:
2026-06-09 14:21:41 +08:00
parent ca71b6d52e
commit 660fa9347c
9 changed files with 222 additions and 16 deletions

View File

@@ -484,19 +484,53 @@ GainNode 的 ramp 目标值 = `Math.min(bgmVolume, bgmDuckLevel × bgmVolume)`
- [x] `public/images/ch{1,2,3}.jpg` — 章节缩略图
- [x] 验证TypeScript + Vite build 通过
### P9 跳过已看 + 倍速播放(待实现)
### P9 跳过已看 + 倍速播放 ✅ 已完成 2026-06-09
目标:玩家重玩时可以跳过已看过的场景或加速播放2x/4x,避免重复等待。
目标:玩家重玩分支时可以跳过已看过的场景或加速播放,避免重复等待,鼓励多次探索不同路线
**核心规则:**
| 决策 | 说明 |
|------|------|
| **判定粒度** | IndexedDB 持久化已看场景列表SaveSystem `watched` 表),跨会话生效 |
| **跳过方式** | 画面右上角浮现"跳过"按钮,点击立即触发 skip |
| **倍速方式** | 画面右上角"倍速"按钮,点击循环切换 1x → 2x → 4x → 1x |
| **两者并存** | 跳过和倍速互不冲突,各用各的按钮 |
| **不可跳过** | 第一次看的场景不可跳(`onVideoEnd` 后才记入已看);`skippable: false` 可永久禁止 |
**新增数据结构:**
```json
{
"id": "tense_moment",
"videoUrl": "/videos/tense.mp4",
"skippable": false,
"choices": [...]
}
```
`skippable` 默认 `true`。设为 `false` 时即使已看过也不显示跳过按钮。
**跳过时的引擎行为:**
```
用户点击跳过按钮
→ engine.skipCurrentScene()
→ videoManager.pause()
→ 直接触发 onVideoEnd(scene) 流程(弹出选项 / 自动跳转 / endGame
→ 和正常播放结束行为完全一致
```
**实现清单:**
- [ ] `engine/systems/SkipSystem.ts`记录已观看的场景 ID 列表(持久化到 IndexedDB
- [ ] `src/components/SkipIndicator.vue` — "按住 Space 跳过" 进度环指示器
- [ ] `engine/core/VideoManager.ts``setPlaybackRate(rate)` 方法(原生 `video.playbackRate`
- [ ] `src/App.vue` — 跳过按钮/快捷键Space 长按 → 进度环走满 → 触发 skip倍速切换按钮1x/2x/4x
- [ ] `engine/core/Engine.ts` — 跳过逻辑:跳过 → 直接触发 `onVideoEnd` 流程;倍速不触发跳过
- [ ] `public/scenes/demo.json` — 添加 `skippable: true/false` 字段(关键场景禁止跳过)
- [ ] 验证:已看场景可跳过、未看不可跳过、倍速切换正常、关键场景不可跳过
- [x] `engine/systems/SaveSystem.ts`DB v4 新增 `watched` 表;`markWatched` / `isWatched` / `getWatchedSceneIds`
- [x] `engine/core/Engine.ts``onVideoEnd` 调用 `onMarkWatched` 回调;`skipCurrentScene()` 暂停视频并触发 ended 流程
- [x] `engine/core/VideoManager.ts``setPlaybackRate(rate)` / `getPlaybackRate()` 封装原生 API
- [x] `engine/types.ts``SceneNode.skippable?: boolean`
- [x] `src/components/PlaybackBar.vue` — 左上角跳过按钮(已看且 skippable 时显示)+ 倍速按钮(循环 1x/2x/4x
- [x] `src/App.vue` — 整合 PlaybackBar`watch` currentScene 更新 canSkip
- [x] `public/scenes/demo.json``qte_success` / `qte_fail``skippable: false`
- [x] 验证TypeScript + Vite build 通过
### P10 键盘/手柄导航(待实现)