- 修复: LiveKit 回环候选生效(宿主机浏览器可直连推流) - 修复: 回放预签名 URL 403(公开端点直接签名,SignedHeaders=host) - 修复: 录像探针补 fileSize/durationSeconds - 修复: 家长录像列表被权限过滤误伤为 0 条;教师/家长列表按角色精确隔离 - 修复: 巡课静音失效(LiveKit attach 强制 unmute,静音时不挂载音轨) - 修复: 教室页自动请求摄像头/麦克风权限,分辨率失败自动降级 - 新增: 浏览器端到端验证脚本 scripts/e2e-browser.mjs(9 项断言全过: 教师推流/家长观看含音频电平实测/巡课默认静音/Egress 录像双轨齐全/ DPlayer 回放/录像权限隔离) - 新增: /parent/today 家长今日课程表、网站 Logo 上传与公开读取 - UI 重做: 虎牙风直播播放器 + DPlayer 回放播放器(视觉统一) - 分角色控制台: 管理端 /admin(16 模块)、教师端 /teacher、家长端 /parent - 直播/录像列表返回班级、课程、教师名称与在线人数 - 18088 本地预览改为 Vite 热更新,README/实现状态文档同步更新 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Code <noreply@anthropic.com>
3.7 KiB
3.7 KiB
实现状态
更新时间:2026-11-22
Java 不安装在宿主机。编译和测试使用 scripts/mvn.ps1,镜像是 maven:3.9.11-eclipse-temurin-21。
真实媒体链路已验证(scripts/e2e-browser.mjs,无头 Chrome + 虚拟设备)
2026-11-22 用真实浏览器跑通完整链路,8 项断言全部通过:
- 教师端自动请求摄像头/麦克风权限,设备独立枚举。
- 教师从浏览器把 720p 视频 + 音频推到 LiveKit,会话进入 LIVE。
- 家长端收到 1280x720 画面(解码 300+ 帧)并实测到远程音频电平(RMS 25)。
- 巡课页多教室同时拉流,默认全部静音,点选一间才出声。
- 管理后台概览显示真实统计与服务状态。
- 结束直播后 Egress 生成 MP4 到 MinIO,ffprobe 探针确认 h264 视频轨 + aac 音频轨齐全(如 6.8MB / 44s)。
- 回放地址(公开端点预签名)浏览器可直连播放。
- 回放页用 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 主色。
本地开发预览
docker compose stop web # 停掉静态容器
cd frontend
npm run dev # 18088,改动即时热更新,API 代理到 8080
生产镜像仍是 docker compose up -d --build web(静态构建,nginx 托管)。
尚未验证
- 阿里云、腾讯云短信和真实 SMTP 只完成协议实现,未用真实密钥发送。
- 压力测试只测过 50 并发的公开接口,未做 100/300 路观看的直播压测。
- 真实摄像头/麦克风/希沃一体机设备兼容性未在实机验证。
- 站内消息收件箱(用户端通知列表)尚未实现。
- 直播趋势图等历史统计曲线需要后端新增聚合接口,目前概览只有当前计数。