xiao12feng 9e1005df88 修复app语音测评、图标、访问课程等问题

2025-12-10 13:15:26 +08:00

6.7 KiB

Raw Blame History

课件管理和视频播放 - 快速参考

🎯 你的配置信息

项目	值
本机IP地址	`192.168.137.1`
后端端口	`30091`
后端访问地址	`http://192.168.137.1:30091`
文件存储路径	`D:\wwwroot\study_web\web\profile\upload\`

📂 文件夹结构

D:\wwwroot\study_web\web\profile\upload\
├── courseware\       # 课件文件（视频、文档等）
├── voice\           # 语音评测录音
├── screenshots\     # 屏幕监控截图
└── avatar\          # 用户头像

创建命令：右键以管理员身份运行 一键配置本地环境.bat

🚀 快速启动流程

1. 配置环境（首次使用）

# 右键以管理员身份运行
一键配置本地环境.bat

2. 启动后端服务

cd Study-Vue-redis\ry-study-admin
mvn spring-boot:run

3. 测试后端是否启动成功

浏览器访问: http://192.168.137.1:30091

4. 编译运行APP

在HBuilderX中打开 fronted_uniapp\fronted_uniapp 项目，运行到真机

📚 课件管理功能

后台管理系统操作

1. 上传课件

登录后台: http://192.168.137.1:30091 或 http://localhost:30091
进入【教学管理】→【课件管理】
点击【新增课件】
填写信息：
- 课件名称: 如"第一课：拼音学习"
- 所属课程: 选择对应课程
- 课件类型: 视频/文档/音频
- 课件文件: 点击上传按钮
- 排序号: 控制显示顺序（数字越小越靠前）
点击【确定】提交

2. 文件上传限制

最大文件大小: 2GB
支持的视频格式: MP4, AVI, MKV, FLV（推荐MP4）
支持的文档格式: PDF, PPT, PPTX, DOC, DOCX
支持的音频格式: MP3, WAV, M4A

3. 课件管理

查看列表: 教学管理 → 课件管理
编辑课件: 点击【修改】按钮
删除课件: 点击【删除】按钮（会同时删除文件）
按课程筛选: 使用课程下拉框筛选

APP端使用

1. 查看课件

登录APP
进入【课程学习】
选择课程
查看课件列表

2. 播放视频

点击视频课件即可播放
支持暂停、快进、调节音量
自动记录学习进度

🎥 视频文件路径说明

路径映射关系

类型	示例
数据库存储	`/profile/upload/2025/12/05/abc123.mp4`
物理路径	`D:\wwwroot\study_web\web\profile\upload\2025\12\05\abc123.mp4`
APP访问URL	`http://192.168.137.1:30091/profile/upload/2025/12/05/abc123.mp4`
后台管理访问	`http://192.168.137.1:30091/profile/upload/2025/12/05/abc123.mp4`

访问流程

用户请求视频
    ↓
http://192.168.137.1:30091/profile/upload/2025/12/05/video.mp4
    ↓
Spring Boot (ResourcesConfig.java)
    ↓
映射到: D:\wwwroot\study_web\web\profile\upload\2025\12\05\video.mp4
    ↓
返回视频文件流
    ↓
浏览器/APP播放器播放

🔧 常用API接口

1. 文件上传

POST http://192.168.137.1:30091/common/upload
Content-Type: multipart/form-data

file: [文件对象]

返回示例:

{
  "code": 200,
  "msg": "操作成功",
  "fileName": "/profile/upload/2025/12/05/abc123.mp4",
  "url": "http://192.168.137.1:30091/profile/upload/2025/12/05/abc123.mp4"
}

2. 课件管理API

功能	方法	URL
获取课件列表	GET	`/study/courseware/list`
获取课件详情	GET	`/study/courseware/{id}`
新增课件	POST	`/study/courseware`
修改课件	PUT	`/study/courseware`
删除课件	DELETE	`/study/courseware/{id}`
APP端获取课件	GET	`/study/courseware/app/list?courseId=xxx`

❓ 常见问题

Q1: APP无法连接后端？

检查清单:

手机和电脑在同一WiFi网络
防火墙已开放30091端口（运行测试配置.bat检查）
后端服务已启动
APP配置的IP是 192.168.137.1

快速测试: 在手机浏览器访问 http://192.168.137.1:30091，如果能打开登录页面，说明网络通畅。

Q2: 视频无法播放？