⚡ Lineage WebSocket API

命名空间: /chatroom  |  连接地址: wss://ws.lineage.chajiapu.com.cn/chatroom

连接认证
wss://ws.lineage.chajiapu.com.cn/chatroom
query.token 或 auth.token（JWT）
// 示例
const socket = io('wss://ws.lineage.chajiapu.com.cn/chatroom', {
  auth: { token: 'your_jwt_token' }
})
客户端发送事件（emit）
EMIT

switch_room — 进入 / 切换房间

字段类型说明
data.roomIdstring房间 ID 必填
socket.emit('switch_room', {
  data: { roomId: '123456' }
})
EMIT

message — 发送消息

字段类型说明
data.roomIdstring房间 ID 必填
data.contentstring消息内容 必填
data.user_infoobject发送者信息
data.attachmentarray附件列表，默认 []
socket.emit('message', {
    roomId: '123456',
    content: '你好！',
    user_info: { nickname: 'Tom' },
    attachment: []
})
EMIT

message_list — 拉取历史消息

字段类型说明
roomIdint房间 ID 必填
pageint页码，默认 1
sizeint每页数量，默认 20
socket.emit('message_list', {
  roomId: 123456,
  page: 1,
  size: 20
})
EMIT

hb — 心跳

socket.emit('hb', {})  // 建议每 30s 发送一次
服务端推送事件（on）
ON

message — 收到新消息

socket.on('message', ({ type, data }) => {
  // type: 'user:message'
  // data: {
  //   id,          // 雪花ID
  //   uid,         // 发送者uid
  //   user_info,   // 发送者信息
  //   content,     // 消息内容
  //   room_id,     // 房间ID
  //   attachment,  // 附件
  //   _ts,         // 时间戳
  // }
})
ON

message_list — 历史消息返回

socket.on('message_list', ({ type, data }) => {
  // type: 'user:message:list'
  // data: [ ...消息对象数组 ]
})
ON

notification — 房间通知

type说明
user:switch:room有用户进入房间
socket.on('notification', ({ type, content }) => {
  // content.user: 进入房间的用户信息
})
ON

error — 业务错误

type说明
user:unjoined未加入圈子
user:not-in-room未切换到对应房间
socket.on('error', ({ type, content }) => { })
ON

authErr — 认证失败

socket.on('authErr', (message) => {
  // message: string 错误原因
})
ON

PONG — 心跳响应

socket.on('PONG', ({ timestamp }) => { })
ON

notice — 通知事件

type说明
lineage:member:join用户申请加入血缘时，通知该血缘相关管理员
lineage:member:confirm用户加入血缘申请处理完成后，通知申请人处理结果
socket.on('notice', ({ type, data }) => {
  // type: 'lineage:member:join'
  // data: {
  //   lineage_id,   // 血缘 ID
  //   user_info,    // 申请加入的用户信息
  // }

  // type: 'lineage:member:confirm'
  // data: {
  //   lineage_id,        // 血缘 ID
  //   role,              // 加入后的角色
  //   status,            // 审核状态
  //   lineage_surname,   // 血缘姓氏
  // }
})