102 lines
2.6 KiB
Markdown
102 lines
2.6 KiB
Markdown
|
# 观看历史功能测试指南
|
|||
|
|
|
|||
|
|
## 功能说明
|
|||
|
|
|
|||
|
|
观看历史功能允许用户查看自己观看过的直播间、作品等内容，并保存到后台。
|
|||
|
|
|
|||
|
|
## 实现内容
|
|||
|
|
|
|||
|
|
### 1. 后台实现
|
|||
|
|
|
|||
|
|
#### 数据存储 (`live-streaming/server/store/viewHistoryStore.js`)
|
|||
|
|
- 记录用户观看历史
|
|||
|
|
- 支持按类型过滤（room/work/profile）
|
|||
|
|
- 自动更新已存在的记录
|
|||
|
|
- 支持分页查询
|
|||
|
|
|
|||
|
|
#### API路由 (`live-streaming/server/routes/viewHistory.js`)
|
|||
|
|
- `POST /api/front/activity/record-view` - 记录观看历史
|
|||
|
|
- `GET /api/front/activity/view-history` - 获取观看历史
|
|||
|
|
- `DELETE /api/front/activity/view-history` - 清除观看历史
|
|||
|
|
- `DELETE /api/front/activity/view-history/:id` - 删除单条记录
|
|||
|
|
|
|||
|
|
### 2. Android端实现
|
|||
|
|
|
|||
|
|
#### RoomDetailActivity
|
|||
|
|
- `recordWatchHistory()` - 进入直播间时记录观看历史
|
|||
|
|
- `updateWatchHistoryWithRoomInfo()` - 房间信息加载后更新详细信息
|
|||
|
|
|
|||
|
|
#### MyRecordsActivity
|
|||
|
|
- 已支持显示观看历史（"观看历史"标签页）
|
|||
|
|
- 支持点击跳转到对应的直播间/作品
|
|||
|
|
|
|||
|
|
## 测试步骤
|
|||
|
|
|
|||
|
|
### 1. 启动后台服务
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cd live-streaming
|
|||
|
|
npm install
|
|||
|
|
npm start
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
后台服务将在 http://localhost:3001 启动
|
|||
|
|
|
|||
|
|
### 2. 测试API（使用Postman或curl）
|
|||
|
|
|
|||
|
|
#### 记录观看历史
|
|||
|
|
```bash
|
|||
|
|
curl -X POST http://localhost:3001/api/front/activity/record-view \
|
|||
|
|
-H "Content-Type: application/json" \
|
|||
|
|
-H "Authorization: 1" \
|
|||
|
|
-d '{
|
|||
|
|
"targetType": "room",
|
|||
|
|
"targetId": "test-room-id",
|
|||
|
|
"targetTitle": "测试直播间",
|
|||
|
|
"coverImage": "https://example.com/cover.jpg",
|
|||
|
|
"streamerName": "测试主播",
|
|||
|
|
"viewDuration": 120
|
|||
|
|
}'
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### 获取观看历史
|
|||
|
|
```bash
|
|||
|
|
curl -X GET "http://localhost:3001/api/front/activity/view-history?page=1&pageSize=20" \
|
|||
|
|
-H "Authorization: 1"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### 清除观看历史
|
|||
|
|
```bash
|
|||
|
|
curl -X DELETE "http://localhost:3001/api/front/activity/view-history" \
|
|||
|
|
-H "Authorization: 1"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3. Android端测试
|
|||
|
|
|
|||
|
|
1. 确保Android应用已连接到后台服务
|
|||
|
|
2. 登录应用
|
|||
|
|
3. 进入任意直播间
|
|||
|
|
4. 观看历史会自动记录
|
|||
|
|
5. 返回首页，进入"我的" -> "我的记录"
|
|||
|
|
6. 切换到"观看历史"标签页
|
|||
|
|
7. 应该能看到刚才观看的直播间
|
|||
|
|
|
|||
|
|
## 数据存储位置
|
|||
|
|
|
|||
|
|
观看历史数据保存在：`live-streaming/data/viewHistory.json`
|
|||
|
|
|
|||
|
|
## 注意事项
|
|||
|
|
|
|||
|
|
1. 用户必须登录才能记录观看历史
|
|||
|
|
2. 同一用户观看同一内容会更新记录而不是创建新记录
|
|||
|
|
3. 观看历史按更新时间倒序排列
|
|||
|
|
4. 支持分页加载，默认每页20条
|
|||
|
|
|
|||
|
|
## 后续优化建议
|
|||
|
|
|
|||
|
|
1. 添加观看时长统计
|
|||
|
|
2. 支持删除单条观看历史
|
|||
|
|
3. 添加观看历史的时间筛选
|
|||
|
|
4. 支持导出观看历史
|
|||
|
|
5. 添加隐私设置（是否记录观看历史）
|