# 后端接口 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之后的新消息