244 lines
6.7 KiB
Markdown
244 lines
6.7 KiB
Markdown
# 课件管理和视频播放 - 快速参考
|
||
|
||
## 🎯 你的配置信息
|
||
|
||
| 项目 | 值 |
|
||
|------|-----|
|
||
| **本机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. 配置环境（首次使用）
|
||
```powershell
|
||
# 右键以管理员身份运行
|
||
一键配置本地环境.bat
|
||
```
|
||
|
||
### 2. 启动后端服务
|
||
```powershell
|
||
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. 上传课件
|
||
1. 登录后台: `http://192.168.137.1:30091` 或 `http://localhost:30091`
|
||
2. 进入【教学管理】→【课件管理】
|
||
3. 点击【新增课件】
|
||
4. 填写信息：
|
||
- **课件名称**: 如"第一课：拼音学习"
|
||
- **所属课程**: 选择对应课程
|
||
- **课件类型**: 视频/文档/音频
|
||
- **课件文件**: 点击上传按钮
|
||
- **排序号**: 控制显示顺序（数字越小越靠前）
|
||
5. 点击【确定】提交
|
||
|
||
#### 2. 文件上传限制
|
||
- **最大文件大小**: 2GB
|
||
- **支持的视频格式**: MP4, AVI, MKV, FLV（推荐MP4）
|
||
- **支持的文档格式**: PDF, PPT, PPTX, DOC, DOCX
|
||
- **支持的音频格式**: MP3, WAV, M4A
|
||
|
||
#### 3. 课件管理
|
||
- **查看列表**: 教学管理 → 课件管理
|
||
- **编辑课件**: 点击【修改】按钮
|
||
- **删除课件**: 点击【删除】按钮（会同时删除文件）
|
||
- **按课程筛选**: 使用课程下拉框筛选
|
||
|
||
### APP端使用
|
||
|
||
#### 1. 查看课件
|
||
1. 登录APP
|
||
2. 进入【课程学习】
|
||
3. 选择课程
|
||
4. 查看课件列表
|
||
|
||
#### 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. 文件上传
|
||
```http
|
||
POST http://192.168.137.1:30091/common/upload
|
||
Content-Type: multipart/form-data
|
||
|
||
file: [文件对象]
|
||
```
|
||
|
||
**返回示例**:
|
||
```json
|
||
{
|
||
"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测试
|
||
- [ ] 文件权限正确（右键 → 属性 → 安全）
|
||
|
||
**测试方法**:
|
||
1. 找到视频在数据库中的路径，如 `/profile/upload/2025/12/05/test.mp4`
|
||
2. 在浏览器访问: `http://192.168.137.1:30091/profile/upload/2025/12/05/test.mp4`
|
||
3. 如果能播放，说明服务器配置正确
|
||
|
||
### Q3: 上传课件失败？
|
||
|
||
**可能原因**:
|
||
1. 文件太大（超过2GB限制）
|
||
2. 目标文件夹不存在或无写权限
|
||
3. 磁盘空间不足
|
||
|
||
**解决方法**:
|
||
1. 检查文件大小
|
||
2. 运行 `一键配置本地环境.bat` 重新创建文件夹
|
||
3. 检查D盘剩余空间
|
||
|
||
### Q4: 如何修改IP地址？
|
||
|
||
**如果你的电脑IP变化了**:
|
||
|
||
1. 修改APP配置文件：
|
||
- 文件: `fronted_uniapp\fronted_uniapp\src\utils\config.js`
|
||
- 第17行: `const DEFAULT_SERVER_HOST = '新的IP地址'`
|
||
- 第19行: `const DEV_SERVER_HOST = '新的IP地址'`
|
||
|
||
2. 重新编译APP
|
||
|
||
3. 或者在APP设置中动态配置（如果实现了设置页面）
|
||
|
||
---
|
||
|
||
## 🔐 安全提示
|
||
|
||
1. **开发环境**: 当前配置适用于局域网开发测试
|
||
2. **生产部署**: 需要修改为公网IP或域名
|
||
3. **防火墙**: 生产环境建议配置更严格的防火墙规则
|
||
4. **文件大小**: 根据实际需求调整上传限制
|
||
5. **备份**: 定期备份 `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中播放测试视频
|
||
|
||
全部通过后，系统即可正常使用！
|