|
|
|
@ -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
2 years ago
