6.7 KiB
6.7 KiB
课件管理和视频播放 - 快速参考
🎯 你的配置信息
| 项目 | 值 |
|---|---|
| 本机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: 视频无法播放?
检查清单:
- 视频文件确实存在于
D:\wwwroot\study_web\web\profile\upload\目录 - 视频格式为MP4(其他格式可能不兼容)
- 在浏览器中直接访问视频URL测试
- 文件权限正确(右键 → 属性 → 安全)
测试方法:
- 找到视频在数据库中的路径,如
/profile/upload/2025/12/05/test.mp4 - 在浏览器访问:
http://192.168.137.1:30091/profile/upload/2025/12/05/test.mp4 - 如果能播放,说明服务器配置正确
Q3: 上传课件失败?
可能原因:
- 文件太大(超过2GB限制)
- 目标文件夹不存在或无写权限
- 磁盘空间不足
解决方法:
- 检查文件大小
- 运行
一键配置本地环境.bat重新创建文件夹 - 检查D盘剩余空间
Q4: 如何修改IP地址?
如果你的电脑IP变化了:
-
修改APP配置文件:
- 文件:
fronted_uniapp\fronted_uniapp\src\utils\config.js - 第17行:
const DEFAULT_SERVER_HOST = '新的IP地址' - 第19行:
const DEV_SERVER_HOST = '新的IP地址'
- 文件:
-
重新编译APP
-
或者在APP设置中动态配置(如果实现了设置页面)
🔐 安全提示
- 开发环境: 当前配置适用于局域网开发测试
- 生产部署: 需要修改为公网IP或域名
- 防火墙: 生产环境建议配置更严格的防火墙规则
- 文件大小: 根据实际需求调整上传限制
- 备份: 定期备份
D:\wwwroot\study_web\web\profile\目录
📞 文件位置速查
| 文件 | 位置 |
|---|---|
| 后端配置 | Study-Vue-redis\ry-study-admin\src\main\resources\application.yml |
| APP配置 | fronted_uniapp\fronted_uniapp\src\utils\config.js |
| 课件控制器 | Study-Vue-redis\ry-study-admin\src\main\java\com\ddnai\web\controller\study\StudyCoursewareController.java |
| 文件上传工具 | Study-Vue-redis\ry-study-common\src\main\java\com\ddnai\common\utils\file\FileUploadUtils.java |
| 资源配置 | Study-Vue-redis\ry-study-admin\src\main\java\com\ddnai\framework\config\ResourcesConfig.java |
📝 测试检查单
使用前请完成以下检查:
- 运行
一键配置本地环境.bat(以管理员身份) - 运行
测试配置.bat验证配置 - 启动后端服务
- 浏览器访问
http://192.168.137.1:30091测试 - 手机浏览器访问测试(手机连接同一WiFi)
- 编译运行APP到真机
- 上传一个测试视频课件
- 在APP中播放测试视频
全部通过后,系统即可正常使用!