98 lines
2.2 KiB
Markdown
98 lines
2.2 KiB
Markdown
# 后端接口 TODO 清单 - 分类管理模块
|
||
|
||
## 1. 获取房间分类列表
|
||
**文件**: `CategoryFilterManager.java`, `MainActivity.java`
|
||
**接口路径**: `GET /api/rooms/categories`
|
||
**请求参数**: 无
|
||
**返回数据**:
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"data": [
|
||
{
|
||
"id": "string",
|
||
"name": "string",
|
||
"iconUrl": "string",
|
||
"roomCount": "number",
|
||
"sortOrder": "number"
|
||
}
|
||
]
|
||
}
|
||
```
|
||
**说明**:
|
||
- 用于显示分类标签页
|
||
- 分类数据应从后端获取，而不是硬编码
|
||
- 支持动态添加/删除分类
|
||
|
||
## 2. 按分类获取房间列表
|
||
**文件**: `CategoryFilterManager.java`, `MainActivity.java`
|
||
**接口路径**: `GET /api/rooms?category={categoryId}`
|
||
**请求参数**:
|
||
- category: 分类ID（必填）
|
||
- page (可选): 页码
|
||
- pageSize (可选): 每页数量
|
||
- sortBy (可选): 排序方式（hot/new/viewers）
|
||
**返回数据**:
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"data": [
|
||
{
|
||
"id": "string",
|
||
"title": "string",
|
||
"streamerName": "string",
|
||
"streamerId": "string",
|
||
"type": "string",
|
||
"categoryId": "string",
|
||
"categoryName": "string",
|
||
"isLive": "boolean",
|
||
"coverUrl": "string",
|
||
"viewerCount": "number",
|
||
"streamUrls": {
|
||
"flv": "string",
|
||
"hls": "string",
|
||
"rtmp": "string"
|
||
}
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
## 3. 获取推荐分类
|
||
**文件**: `MainActivity.java`
|
||
**接口路径**: `GET /api/rooms/categories/recommended`
|
||
**请求参数**:
|
||
- userId (可选): 用户ID（从token中获取，用于个性化推荐）
|
||
**返回数据**:
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"data": [
|
||
{
|
||
"id": "string",
|
||
"name": "string",
|
||
"iconUrl": "string",
|
||
"roomCount": "number"
|
||
}
|
||
]
|
||
}
|
||
```
|
||
**说明**:
|
||
- 根据用户观看历史推荐分类
|
||
- 如果用户未登录，返回热门分类
|
||
|
||
## 分类筛选流程
|
||
|
||
### 前端实现
|
||
1. 页面加载时获取分类列表
|
||
2. 显示分类标签页
|
||
3. 用户点击分类标签
|
||
4. 调用按分类获取房间列表接口
|
||
5. 显示筛选结果
|
||
|
||
### 性能优化
|
||
- 缓存分类列表（本地存储）
|
||
- 异步筛选，避免阻塞UI
|
||
- 使用 RecyclerView 的 DiffUtil 优化列表更新
|
||
- 保存用户最后选中的分类（SharedPreferences）
|