zhibo/live-streaming/test-view-history.md

观看历史功能测试指南

功能说明

观看历史功能允许用户查看自己观看过的直播间、作品等内容，并保存到后台。

实现内容

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. 启动后台服务

cd live-streaming
npm install
npm start

后台服务将在 http://localhost:3001 启动

2. 测试API（使用Postman或curl）

记录观看历史

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
  }'

获取观看历史

curl -X GET "http://localhost:3001/api/front/activity/view-history?page=1&pageSize=20" \
  -H "Authorization: 1"

清除观看历史

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. 添加隐私设置（是否记录观看历史）