EasyJSSDK
一个简单易用的 WuKongIM 通讯 SDK，基于其 JSON-RPC 协议。(地址：https://gitee.com/WuKongDev/EasyJSSDK)
WuKongIM 开源地址：https://gitee.com/WuKongDev/WuKongIM
安装
npm install easyjssdk
使用方法
// 引入必要的组件
import { WKIM, WKIMChannelType, WKIMEvent } from 'easyjssdk';
// 1. 初始化
const im = WKIM.init("ws://your-wukongim-server.com:5200", {
uid: "your_user_id", // 你的用户 ID
token: "your_auth_token" // 你的认证令牌
// deviceId: "optional_device_id", // 可选的设备 ID
// deviceFlag: 2 // 可选的设备标识 (1:APP, 2:WEB, 默认为 2)
});
// 2. 收消息
im.on(WKIMEvent.Message, (message) => {
console.log("收到消息:", message);
// 处理收到的消息 (message.payload, message.fromUid 等)
});
// 3. 连接到服务器
im.connect()
// 4. 示例：连接成功后发送一条消息
const targetUserId = "friend_user_id"; // 目标用户 ID
const messagePayload = { type: 1, content: "来自 EasyJSSDK 的问候!" }; // 你的自定义消息负载
return im.send(targetUserId, WKIMChannelType.Person, messagePayload);
开发
- 克隆本仓库。
- 运行
npm install 安装依赖。
- 运行
npm run build 将 TypeScript 编译成 JavaScript。
运行示例程序
仓库中包含一个简单的 HTML/JS 示例用于测试 SDK。
-
构建 SDK: 确保你已经先构建了库文件：
<pre>
npm run build
-
启动本地服务器: 在你的终端中，导航到本项目的根目录 (EasyJSSDK)。你需要使用一个本地 Web 服务器来提供文件服务，因为示例使用了 ES Modules。一个简单的方法是使用 http-server：
<pre>
# 如果你还没有 http-server，请全局安装:
npm install -g http-server
从 EasyJSSDK 目录运行服务器:
http-server .
或者，使用 VS Code 的 "Live Server" 扩展或其他任何本地服务器，确保它从项目根目录 (<code>EasyJSSDK</code>) 提供服务。
</li>
<li>
<strong>打开示例:</strong> 打开你的 Web 浏览器并访问示例页面，通常是： <code>http://localhost:8080/example/</code> (如果你的服务器使用了不同的端口号，请相应调整)。
</li>
<li>
<strong>测试:</strong> 输入你的 WuKongIM 服务器信息 (URL, UID, Token)，然后使用按钮进行连接、断开和发送消息的测试。
</li>
