48 lines
2.3 KiB
Markdown
48 lines
2.3 KiB
Markdown
# scense 游戏展示模块（元景 W-08）
|
||
|
||
## 功能
|
||
游戏列表入口 / 点击开始玩（初始化 W-10 世界运行态进入）/ 暂停 / 继续 / 结束结算 / 重新开始 / 分数结果展示 / 分享链接进入 / 玩中交互（点选移动实体触发脚本逻辑）/ 退出保存进度。
|
||
|
||
## 数据表
|
||
| 表 | 作用 | 关键字段 |
|
||
|----|------|----------|
|
||
| game_session | 游戏会话 | status(created/playing/paused/ended), score, level, elapsed_ms, progress_json, share_token |
|
||
| game_result | 游戏结果 | session_id, score, duration_ms, level, result_json |
|
||
|
||
## 会话状态机
|
||
- 开始玩：无会话→playing；已有 playing/paused→恢复 playing（续玩）
|
||
- playing ⇄ paused（pause/resume）
|
||
- playing/paused → ended（end 唯一结算出口，写 game_result）
|
||
- 任意状态 → playing（restart 重置分数/关卡）
|
||
- save 保存进度快照（不改变状态）
|
||
|
||
## API 端点（wwwroot/game/api/*.dspy，全部 logined）
|
||
| 文件 | 功能 | 功能点 |
|
||
|------|------|--------|
|
||
| game_list.dspy | 游戏列表 + 历史会话/结果 | W-08a |
|
||
| game_start.dspy | 开始玩（进入运行态） | W-08b |
|
||
| game_pause.dspy | 暂停 | W-08c |
|
||
| game_resume.dspy | 继续 | W-08d |
|
||
| game_end.dspy | 结束结算（写 game_result） | W-08e/g |
|
||
| game_restart.dspy | 重新开始（重置） | W-08f |
|
||
| game_share.dspy | 生成/解析分享链接 | W-08h |
|
||
| game_save.dspy | 保存进度快照 | W-08j |
|
||
|
||
## 前端
|
||
- `game/index.ui` — bricks 游戏列表入口页
|
||
- `game/game_play.html` — 全屏游戏页（canvas + HUD + 结算面板 + 交互），验收入口
|
||
- `game/game.js` — 游戏交互（开始/暂停/继续/结束/重开/分享/保存/点选实体）
|
||
- `game/game_list.js` — 列表页渲染
|
||
|
||
## 依赖
|
||
- W-10 runtime（runtime.js RuntimeEngine，前端运行态，服务端辅助可选）
|
||
- world 模块（游戏世界来源，防御式降级独立模式）
|
||
- sqlor / ahserver / ServerEnv
|
||
|
||
## 集成
|
||
1. `app/sage.py`: `from scense.init import load_scense` + `load_scense()` in init()
|
||
2. build.sh 安装循环添加 scense
|
||
3. `scripts/load_path.py` 注册 RBAC 路径（禁通配符）
|
||
4. `global_menu.ui` 添加菜单项 `{{entire_url('/scense/game/index.ui')}}`
|
||
5. 部署目标 `/d/scense/scense_app`：模块 wwwroot 软链接 + pip install -e
|