获取全部用户

src/class/httphandler.ts

@@ -1116,8 +1116,8 @@ function getAllConnectionIds(req: Request, res: Response): void {
  * @swagger
  * /signaling/users:
  *   get:
- *     summary: 获取在线WebSocket用户列表
- *     description: 获取所有在线WebSocket用户，支持按 connectionId 过滤指定房间内的用户
+ *     summary: 获取全部在线WebSocket用户列表
+ *     description: 获取所有当前已建立WebSocket连接的用户，包括未加入房间的大厅用户；支持按 connectionId 过滤指定房间内的用户
  *     parameters:
  *       - in: query
  *         name: connectionId
@@ -1146,8 +1146,11 @@ function getAllConnectionIds(req: Request, res: Response): void {
  *                         description: 参与者ID
  *                       role:
  *                         type: string
- *                         enum: [host, participant]
+ *                         enum: [host, participant, idle]
  *                         description: 角色
+ *                       socketId:
+ *                         type: string
+ *                         description: WebSocket连接ID
  *                       userId:
  *                         type: string
  *                         description: 用户ID
@@ -1159,7 +1162,7 @@ function getAllConnectionIds(req: Request, res: Response): void {
  *                         description: 用户头像URL
  *                 totalCount:
  *                   type: number
- *                   description: 在线用户总数
+ *                   description: 在线WebSocket用户总数
  */
 function getOnlineUsers(req: Request, res: Response): void {
   const connectionId = typeof req.query.connectionId === 'string' ? req.query.connectionId : undefined;