82 lines
2.0 KiB
Markdown
82 lines
2.0 KiB
Markdown
# 后端接口 TODO 清单 - 用户头像加载模块
|
||
|
||
## 1. 获取用户头像
|
||
**文件**: `ConversationMessagesAdapter.java`, `ConversationsAdapter.java`, `FriendsAdapter.java`
|
||
**接口路径**: `GET /api/users/{userId}/avatar`
|
||
**请求参数**: userId (路径参数)
|
||
**返回数据**:
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"data": {
|
||
"avatarUrl": "string"
|
||
}
|
||
}
|
||
```
|
||
**说明**:
|
||
- 如果消息对象（ChatMessage/ConversationItem/FriendItem）已包含 avatarUrl 字段，直接使用该URL加载头像
|
||
- 如果 avatarUrl 为空，则根据 userId 调用此接口获取头像URL
|
||
- 建议在后端返回消息时直接包含 avatarUrl，减少额外请求
|
||
|
||
## 2. 获取用户在线状态
|
||
**文件**: `FriendsAdapter.java`
|
||
**接口路径**: `GET /api/users/{userId}/status`
|
||
**请求参数**: userId (路径参数)
|
||
**返回数据**:
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"data": {
|
||
"isOnline": "boolean",
|
||
"lastActiveTime": "number"
|
||
}
|
||
}
|
||
```
|
||
**说明**:
|
||
- 用于显示好友列表中的在线状态
|
||
- 建议使用 WebSocket 实时推送在线状态变化
|
||
- 备选方案：轮询获取（每30秒一次）
|
||
|
||
## 3. 批量获取用户头像
|
||
**文件**: 多个适配器文件
|
||
**接口路径**: `POST /api/users/avatars/batch`
|
||
**请求参数**:
|
||
```json
|
||
{
|
||
"userIds": ["string"]
|
||
}
|
||
```
|
||
**返回数据**:
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"data": {
|
||
"userId1": "avatarUrl1",
|
||
"userId2": "avatarUrl2"
|
||
}
|
||
}
|
||
```
|
||
**说明**:
|
||
- 用于批量获取多个用户的头像URL
|
||
- 减少网络请求次数，提升性能
|
||
- 适用于列表页面（消息列表、好友列表等）
|
||
|
||
## 头像加载优化建议
|
||
|
||
### 1. 缓存策略
|
||
- 使用 Glide 的磁盘缓存和内存缓存
|
||
- 设置合理的缓存过期时间（如7天）
|
||
|
||
### 2. 占位图
|
||
- 加载中显示默认头像
|
||
- 加载失败显示默认头像
|
||
- 根据用户名生成不同颜色的默认头像
|
||
|
||
### 3. 图片压缩
|
||
- 后端返回不同尺寸的头像URL（缩略图、原图）
|
||
- 列表页面使用缩略图，详情页面使用原图
|
||
|
||
### 4. 预加载
|
||
- 在列表滚动时预加载即将显示的头像
|
||
- 使用 Glide 的 preload 功能
|