# 观看历史功能测试指南

## 功能说明

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

## 实现内容

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