|
|
@@ -8,7 +8,7 @@
|
|
|
|
|
|
|
|
|
#### 近期更新
|
|
|
-即将发布2.0版本，本次更新主要是加入了uniapp版本，支持移动端和web端同时在线
|
|
|
+发布2.0版本，本次更新主要是加入了uniapp版本，支持移动端和web端同时在线
|
|
|
|
|
|
感兴趣的小伙伴，可在下方扫码抢先体验微信小程序
|
|
|
|
|
|
@@ -65,18 +65,24 @@ java -jar ./im-platform/target/im-platform.jar
|
|
|
java -jar ./im-server/target/im-server.jar
|
|
|
```
|
|
|
|
|
|
-3.启动前端ui
|
|
|
+3.启动前端web
|
|
|
```
|
|
|
cd im-ui
|
|
|
npm install
|
|
|
npm run serve
|
|
|
```
|
|
|
+访问 http://localhost:8080
|
|
|
+
|
|
|
+
|
|
|
+4.启动uniapp-h5
|
|
|
+将im-uniapp目录导入HBuilder X,点击菜单"运行"->"开发环境-h5"
|
|
|
+访问 http://localhost:5173
|
|
|
+
|
|
|
|
|
|
-4.访问localhost:8080
|
|
|
#### 快速接入
|
|
|
消息推送的请求代码已经封装在im-client包中，对于需要接入im-server的小伙伴，可以按照下面的教程快速的将IM功能集成到自己的项目中。
|
|
|
|
|
|
-注意服务器端和网页端都需要接入，服务器端发送消息，网页端接收消息。
|
|
|
+注意服务器端和前端都需要接入，服务器端发送消息，前端接收消息。
|
|
|
|
|
|
4.1 服务器端接入
|
|
|
|
|
|
@@ -85,7 +91,7 @@ npm run serve
|
|
|
<dependency>
|
|
|
<groupId>com.bx</groupId>
|
|
|
<artifactId>im-client</artifactId>
|
|
|
- <version>1.1.0</version>
|
|
|
+ <version>2.0.0</version>
|
|
|
</dependency>
|
|
|
```
|
|
|
内容使用了redis进行通信,所以要配置redis地址：
|
|
|
@@ -104,20 +110,16 @@ public class IMClient {
|
|
|
/**
|
|
|
* 发送私聊消息
|
|
|
*
|
|
|
- * @param recvId 接收用户id
|
|
|
- * @param messageInfo 消息体，将转成json发送到客户端
|
|
|
+ * @param message 私有消息
|
|
|
*/
|
|
|
- void sendPrivateMessage(Long recvId, PrivateMessageInfo... messageInfo)；
|
|
|
-
|
|
|
+ public<T> void sendPrivateMessage(IMPrivateMessage<T> message);
|
|
|
|
|
|
/**
|
|
|
- * 发送群聊消息
|
|
|
+ * 发送群聊消息（发送结果通过MessageListener接收）
|
|
|
*
|
|
|
- * @param recvIds 群聊用户id列表
|
|
|
- * @param messageInfo 消息体，将转成json发送到客户端
|
|
|
+ * @param message 群聊消息
|
|
|
*/
|
|
|
- void sendGroupMessage(List<Long> recvIds, GroupMessageInfo... messageInfo)；
|
|
|
-
|
|
|
+ public<T> void sendGroupMessage(IMGroupMessage<T> message);
|
|
|
}
|
|
|
```
|
|
|
|
|
|
@@ -127,38 +129,43 @@ public class IMClient {
|
|
|
private IMClient imClient;
|
|
|
|
|
|
public void sendMessage(){
|
|
|
- PrivateMessageInfo messageInfo = new PrivateMessageInfo();
|
|
|
- Long recvId = 1L;
|
|
|
- messageInfo.setId(123L);
|
|
|
- messageInfo.setContent("你好呀");
|
|
|
- messageInfo.setType(MessageType.TEXT.getCode());
|
|
|
- messageInfo.setSendId(userId);
|
|
|
- messageInfo.setRecvId(recvId);
|
|
|
- messageInfo.setSendTime(new Date());
|
|
|
- imClient.sendPrivateMessage(recvId,messageInfo);
|
|
|
+ IMPrivateMessage<PrivateMessageVO> sendMessage = new IMPrivateMessage<>();
|
|
|
+ // 发送方的id和终端类型
|
|
|
+ sendMessage.setSender(new IMUserInfo(1L, IMTerminalType.APP.code()));
|
|
|
+ // 对方的id
|
|
|
+ sendMessage.setRecvId(2L);
|
|
|
+ // 推送给对方所有终端
|
|
|
+ sendMessage.setRecvTerminals(IMTerminalType.codes());
|
|
|
+ // 同时推送给自己的其他类型终端
|
|
|
+ sendMessage.setSendToSelf(true);
|
|
|
+ // 需要回推发送结果，将在IMListener接收发送结果
|
|
|
+ sendMessage.setSendResult(true);
|
|
|
+ // 推送的内容
|
|
|
+ sendMessage.setData(msgInfo);
|
|
|
+ // 推送消息
|
|
|
+ imClient.sendPrivateMessage(sendMessage);
|
|
|
}
|
|
|
|
|
|
```
|
|
|
-
|
|
|
-如果需要对消息发送的结果进行监听的话，实现MessageListener,并加上@IMListener即可
|
|
|
+监听发送结果:
|
|
|
+1.编写消息监听类，实现MessageListener,并加上@IMListener
|
|
|
+2.发送消息时指定sendResult为true
|
|
|
```
|
|
|
@Slf4j
|
|
|
@IMListener(type = IMListenerType.ALL)
|
|
|
public class PrivateMessageListener implements MessageListener {
|
|
|
|
|
|
@Override
|
|
|
- public void process(SendResult result){
|
|
|
- PrivateMessageInfo messageInfo = (PrivateMessageInfo) result.getMessageInfo();
|
|
|
- if(result.getStatus().equals(IMSendStatus.SUCCESS)){
|
|
|
- // 消息发送成功
|
|
|
- log.info("消息已读，消息id:{}，发送者:{},接收者:{}",messageInfo.getId(),messageInfo.getSendId(),messageInfo.getRecvId());
|
|
|
+ public void process(IMSendResult<PrivateMessageVO> result){
|
|
|
+ PrivateMessageVO messageInfo = result.getData();
|
|
|
+ if(result.getCode().equals(IMSendCode.SUCCESS.code())){
|
|
|
+ log.info("消息发送成功，消息id:{}，发送者:{},接收者:{},终端:{}",messageInfo.getId(),result.getSender().getId(),result.getReceiver().getId(),result.getReceiver().getTerminal());
|
|
|
}
|
|
|
}
|
|
|
-
|
|
|
}
|
|
|
```
|
|
|
|
|
|
-4.2 网页端接入
|
|
|
+4.2 前端接入
|
|
|
首先将im-ui/src/api/wssocket.js拷贝到自己的项目。
|
|
|
|
|
|
接入代码如下：
|
|
|
@@ -167,23 +174,23 @@ import * as wsApi from './api/wssocket';
|
|
|
|
|
|
let wsUrl = 'ws://localhost:8878/im'
|
|
|
let userId = 1;
|
|
|
-wsApi.createWebSocket(wsUrl , userId);
|
|
|
+let token = "您的token";
|
|
|
+wsApi.createWebSocket(wsUrl , userId,token);
|
|
|
wsApi.onopen(() => {
|
|
|
// 连接打开
|
|
|
console.log("连接成功");
|
|
|
});
|
|
|
-wsApi.onmessage((cmd,messageInfo) => {
|
|
|
+wsApi.onmessage((cmd,msgInfo) => {
|
|
|
if (cmd == 2) {
|
|
|
// 异地登录，强制下线
|
|
|
console.log("您已在其他地方登陆，将被强制下线");
|
|
|
} else if (cmd == 3) {
|
|
|
// 私聊消息
|
|
|
- console.log(messageInfo);
|
|
|
+ console.log(msgInfo);
|
|
|
} else if (cmd == 4) {
|
|
|
// 群聊消息
|
|
|
- console.log(messageInfo);
|
|
|
+ console.log(msgInfo);
|
|
|
}
|
|
|
-
|
|
|
})
|
|
|
```
|
|
|
|
|
|
@@ -207,14 +214,18 @@ wsApi.onmessage((cmd,messageInfo) => {
|
|
|
群聊列表：
|
|
|
|
|
|
|
|
|
+小程序:
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
|
|
|
#### QQ交流群
|
|
|
|
|
|
|
|
|
|
|
|
-有任何问题，欢迎star后加群交流~
|
|
|
+欢迎进群与小伙们一起交流，加群前记得要先star哦,加群时请备注您的gitee账号
|
|
|
|
|
|
|
|
|
#### 点下star吧
|
|
|
-喜欢的朋友麻烦点个star，鼓励一下作者吧！
|
|
|
+如果项目对您有帮助，帮忙点亮star，支持一下作者吧！
|
|
|
|
xsx
