用户

WuKongIM 用户的核心结构和管理方法

​

概念解释

​

什么是用户？

用户（User）是 WuKongIM 系统中的基本实体，代表使用即时通讯服务的个人或应用。每个用户都有唯一的标识符和相关属性，是消息发送和接收的主体。

​

为什么用户很重要？

• 身份标识：用户 ID 是系统中唯一标识一个用户的关键
• 权限基础：所有的消息发送、接收权限都基于用户身份
• 状态管理：用户的在线状态决定了消息的推送方式和时机

​

与其他概念的关系

• 消息（Message）：用户是消息的发送者和接收者
• 频道（Channel）：用户通过频道进行交流，个人频道的 ID 就是用户 ID
• 会话（Conversation）：用户的会话列表显示了该用户参与的所有聊天
• 设备（Device）：一个用户可以在多个设备上登录使用

​

核心结构

用户包含以下核心属性：

属性	类型	说明
uid	string	用户唯一标识符
online	integer	在线状态（0=离线，1=在线）
device_flag	integer	设备类型标识

​

设备标识类型

值	设备类型	说明
1	iOS	iPhone、iPad 设备
2	Android	Android 设备
3	Web	浏览器、Web 应用
4	Desktop	桌面应用

​

用户示例

{
  "uid": "user123",
  "online": 1,
  "device_flag": 1
}

​

相关 API 端点

端点	方法	说明
/user/onlinestatus	POST	查询用户在线状态
/user/token	POST	更新用户 Token
/user/device_quit	POST	强制设备下线
/user/systemuids	GET	获取系统用户列表

​

EasySDK 代码示例

​

用户初始化和连接

Web

import { WKIM, WKIMEvent } from 'easyjssdk';

// 初始化 SDK
const im = WKIM.init("ws://your-server.com:5200", {
  uid: "user123",                    // 用户唯一标识
  token: "your_auth_token"           // 用户认证令牌
});

// 监听连接状态
im.on(WKIMEvent.Connect, (result) => {
  console.log('用户已连接:', result);
});

im.on(WKIMEvent.Disconnect, (disconnectInfo) => {
  console.log('用户已断开连接:', disconnectInfo);
});

// 连接到服务器
try {
  await im.connect();
  console.log("连接成功！");
} catch (error) {
  console.error("连接失败:", error);
}

​

用户状态管理

Web

// 检查连接状态
const isConnected = im.isConnected();
console.log('连接状态:', isConnected);

// 断开连接
await im.disconnect();

// 监听错误事件
im.on(WKIMEvent.Error, (error) => {
  console.log('发生错误:', error);
});

WuKongIM 专注于消息传输，用户的详细资料（如昵称、头像等）通常由应用层管理。