72 lines
1.5 KiB
Markdown
72 lines
1.5 KiB
Markdown
|
# 后端接口 TODO 清单 - 直播间弹幕模块
|
|||
|
|
|
|||
|
|
## 1. 发送直播间弹幕消息
|
|||
|
|
**文件**: `RoomDetailActivity.java`
|
|||
|
|
**接口路径**: `POST /api/rooms/{roomId}/messages`
|
|||
|
|
**请求参数**:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"roomId": "string",
|
|||
|
|
"message": "string",
|
|||
|
|
"userId": "string"
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
**返回数据**:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"code": 200,
|
|||
|
|
"data": {
|
|||
|
|
"messageId": "string",
|
|||
|
|
"userId": "string",
|
|||
|
|
"username": "string",
|
|||
|
|
"avatarUrl": "string",
|
|||
|
|
"message": "string",
|
|||
|
|
"timestamp": "number"
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 2. 获取历史弹幕消息
|
|||
|
|
**文件**: `RoomDetailActivity.java`
|
|||
|
|
**接口路径**: `GET /api/rooms/{roomId}/messages`
|
|||
|
|
**请求参数**:
|
|||
|
|
- roomId: 房间ID（路径参数）
|
|||
|
|
- limit (可选): 获取最近N条消息，默认50
|
|||
|
|
**返回数据**:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"code": 200,
|
|||
|
|
"data": [
|
|||
|
|
{
|
|||
|
|
"messageId": "string",
|
|||
|
|
"userId": "string",
|
|||
|
|
"username": "string",
|
|||
|
|
"avatarUrl": "string",
|
|||
|
|
"message": "string",
|
|||
|
|
"timestamp": "number"
|
|||
|
|
}
|
|||
|
|
]
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 3. 接收实时弹幕消息（WebSocket）
|
|||
|
|
**文件**: `RoomDetailActivity.java`
|
|||
|
|
**WebSocket 连接**: `ws://api.example.com/rooms/{roomId}/chat`
|
|||
|
|
**接收消息格式**:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"type": "message",
|
|||
|
|
"data": {
|
|||
|
|
"messageId": "string",
|
|||
|
|
"userId": "string",
|
|||
|
|
"username": "string",
|
|||
|
|
"avatarUrl": "string",
|
|||
|
|
"message": "string",
|
|||
|
|
"timestamp": "number"
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
**备选方案**: 轮询获取新消息
|
|||
|
|
- 接口路径: `GET /api/rooms/{roomId}/messages?lastMessageId={lastId}`
|
|||
|
|
- 每3-5秒轮询一次，获取lastMessageId之后的新消息
|