# 实现状态 更新时间:2026-11-22 Java 不安装在宿主机。编译和测试使用 `scripts/mvn.ps1`,镜像是 `maven:3.9.11-eclipse-temurin-21`。 ## 真实媒体链路已验证(scripts/e2e-browser.mjs,无头 Chrome + 虚拟设备) 2026-11-22 用真实浏览器跑通完整链路,8 项断言全部通过: 1. 教师端自动请求摄像头/麦克风权限,设备独立枚举。 2. 教师从浏览器把 720p 视频 + 音频推到 LiveKit,会话进入 LIVE。 3. 家长端收到 1280x720 画面(解码 300+ 帧)并实测到远程音频电平(RMS 25)。 4. 巡课页多教室同时拉流,默认全部静音,点选一间才出声。 5. 管理后台概览显示真实统计与服务状态。 6. 结束直播后 Egress 生成 MP4 到 MinIO,ffprobe 探针确认 h264 视频轨 + aac 音频轨齐全(如 6.8MB / 44s)。 7. 回放地址(公开端点预签名)浏览器可直连播放。 8. 回放页用 DPlayer 播放,1280px 画面正常。 说明:以上为**虚拟设备测试**。真实摄像头、真实麦克风和希沃一体机的兼容性仍需在实机上验证,未验证前不得宣称通过。 ## 本次修复的问题 - 回放地址 403:MinIO 预签名之前用内部端点签名后改写主机,`SignedHeaders=host` 使签名失效。改为用公开端点客户端直接签名(客户端显式设置 region,签名过程不再访问服务器)。 - 录像 fileSize/durationSeconds 为空:探针补 `-show_format` 并回写对象大小。 - 巡课/观看静音失效:LiveKit SDK attach 会强制 `element.muted=false`,改为静音时不挂载音轨、取消静音时再挂载。 - 教室页不弹权限询问:进入教室页自动 `getUserMedia` 请求权限并枚举设备,分辨率默认“自动”,指定分辨率失败自动降级。 - SMTP 支持免认证服务器(本地 MailHog 联调用)。 - 直播列表/详情、录像列表返回班级、课程、教师名称与在线人数。 - 家长首页:今日课程表接口 `/parent/today`(含节次时间与进行中状态)。 - 网站 Logo 上传(/admin/site-logo)与公开读取(/api/public/site-logo)。 - 订阅端身份唯一化(u-{id}-watch-{nano}),同一家长多端观看互不挤下线;撤销绑定时按前缀移除全部观看会话。 ## 前端结构(2026-11-22 重做) - 角色控制台:管理员 `/admin`、教师 `/teacher`、家长 `/parent`、巡课 `/inspect`,登录后按角色跳转,`/` 为落地页。 - 播放器:回放用 DPlayer(样式内置 `src/assets/dplayer.css`),直播用自定义虎牙风播放器 `components/LivePlayer.vue`,两套控制条视觉一致。 - 管理后台拆分为 `views/admin/*` 16 个模块:概览/学校/年级/班级/课程/课表/用户/绑定审核/直播/录像/巡课记录/邮件短信/通知模板/存储/日志/系统设置(网站、Logo、注册审核、安全、节次、服务状态)。 - 主题:浅色/深色跟随站点设置,用户可本机覆盖(localStorage),主题色后台可改并同步到 Element Plus 主色。 ## 本地开发预览 ```powershell docker compose stop web # 停掉静态容器 cd frontend npm run dev # 18088,改动即时热更新,API 代理到 8080 ``` 生产镜像仍是 `docker compose up -d --build web`(静态构建,nginx 托管)。 ## 尚未验证 - 阿里云、腾讯云短信和真实 SMTP 只完成协议实现,未用真实密钥发送。 - 压力测试只测过 50 并发的公开接口,未做 100/300 路观看的直播压测。 - 真实摄像头/麦克风/希沃一体机设备兼容性未在实机验证。 - 站内消息收件箱(用户端通知列表)尚未实现。 - 直播趋势图等历史统计曲线需要后端新增聚合接口,目前概览只有当前计数。