• IMLib / IMKit >
 
• 含 UI SDK（IMKit） >
 
• 定制化 >
 
• 拦截消息

拦截消息

IMKit 支持设置消息拦截器 MessageInterceptor，可在消息发送前、发送后、接收时、插入本地数据库前进行拦截，方便应用程序进行自定义处理。

消息拦截器说明

MessageInterceptor 是一个接口类，包含以下方法。

在上述所有方法中返回 false 表示 App 仅需要拦截处理，处理完毕后由 SDK 完成后续流程。返回 true 表示 App 需要在拦截后自行处理后续流程，例如 App 希望在处理完毕后自行发送修改后的消息，可返回 true。

设置消息拦截器

使用 IMCenter 的 setMessageInterceptor 设置消息拦截器。代码示例说明如下：

• 在 interceptOnSendMessage 方法中拦截并修改消息推送内容
• 在 interceptOnInsertOutgoingMessage 方法中拦截并修改图片和 GIF 消息扩展

 
private void initInterceptor() {
    IMCenter.getInstance().setMessageInterceptor(
    new MessageInterceptor() {
        @Override
        public boolean interceptReceivedMessage(
            Message message,
            int left,
            boolean hasPackage,
            boolean offline) {
            return false;
        }

        @Override
        public boolean interceptOnSendMessage(Message message) {
            MessageContent messageContent = message.getContent();
            String language = mContext.getResources().getConfiguration().locale.getLanguage();
            if (language.endsWith("en")) { // 手机系统语言为英文
                if (messageContent instanceof VoiceMessage) {
                    MessagePushConfig messagePushConfig = message.getMessagePushConfig();
                    if (messagePushConfig == null){
                        messagePushConfig = new MessagePushConfig();
                        message.setMessagePushConfig(messagePushConfig);
                    }
                    messagePushConfig.setPushContent("[voice]");// 语音消息时推送显示为 "\[voice\]"
                }
            }
            return false;

            }

        @Override
        public boolean interceptOnSentMessage(Message message) {
            if (message != null) {
            message.setMessageConfig(null);
            }

            return false;
        }


        @Override
        public boolean interceptOnInsertOutgoingMessage(
            Conversation.ConversationType type,
            String targetId,
            Message.SentStatus sentStatus,
            MessageContent content,
            long time) {
            return false;
            }


        @Override
            public boolean interceptOnInsertOutgoingMessage(Conversation.ConversationType type, String targetId, Message.SentStatus sentStatus,
                                                            MessageContent content, long time, RongIMClient.ResultCallback<Message> callback) {
               //含 UI 集成设置图片消息可扩展时，此方法 return true，构建 message 将可扩展属性设置为 true，并调用 callback.onSuccess(message);
                Message message=Message.obtain(targetId,type,content);
                message.setCanIncludeExpansion(true);
                callback.onSuccess(message);
                return true;
            }

        @Override
        public boolean interceptOnInsertIncomingMessage(
            Conversation.ConversationType type,
            String targetId,
            String senderId,
            Message.ReceivedStatus receivedStatus,
            MessageContent content,
            long time) {
            return false;
            }
        });

        }
              

                
已复制
                复制代码
              
              
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74

如何拦截 IMKit 内置会话页面发送的图片和 GIF 消息

使用 IMKit 内置会话页面发送图片和 GIF 消息时，SDK 会先在内部调用插入消息方法将消息插入本地消息数据库，再调用发送消息方法。如果应用程序有以下需求：

• 对图片消息和 GIF 消息设置消息扩展，需要打开图片消息和 GIF 消息的可扩展属性（setCanIncludeExpansion(true)）。
• 修改图片消息和 GIF 消息的部分数据，例如缩略图、或者消息内容体内的 extra 字段等。
• 彻底拦截图片消息和 GIF 消息，由应用程序自定义处理。

必须在消息插入本地数据库前拦截图片、GIF 消息，使用以下方法进行拦截：

 
default boolean interceptOnInsertOutgoingMessage(
        Conversation.ConversationType type,
        String targetId,
        Message.SentStatus sentStatus,
        MessageContent content,
        long time,
        RongIMClient.ResultCallback<Message> callback)
              

                
已复制
                复制代码
              
              
1
2
3
4
5
6
7

应用程序处理完毕后：

• 如需 SDK 继续发送被拦截的消息，需要调用 callback.onSuccess(message) 表示交给 SDK 继续发送该消息，此时必须在 interceptOnInsertOutgoingMessage 方法中返回 true，否则会发出两条内容重复的消息。
• 如需彻底拦截，则调用 callback.onError(IRongCoreEnum.CoreErrorCode.PARAMETER_ERROR)，并在 interceptOnInsertOutgoingMessage 中返回 true。