环信IM集成教程---消息转发合并转发的实现

前言

在发送消息体系中，转发消息是一个重要的环节，可以单条转发也可以合并转发。本文教大家在接入环信IM过程中如何实现单条转发，合并转发消息功能，同时举例一些容易踩坑的位置，以便大家尽快顺利的实现转发消息功能。

环信4.4.0以上（包含4.4.0）的SDK版本，附件类消息支持不下载即可转发；如果还在使用之前版本的同学，建议升级到4.4.0或是先下载到本地，再发送（本篇文章是基于4.4.0的SDK实现的）

前提条件：

完成环信IM SDK的初始化
完成发送消息的操作

功能实现：

一. 单条消息转发

1.发送方转发单条消息；

代码如下：

EMMessage.Type type = message.getType();
        EMMessage msgForForward = EMMessage.createSendMessage(type);
        msgForForward.setTo(toChatUsername);
        switch (type) {
            case TXT: {
                EMTextMessageBody body = (EMTextMessageBody) message.getBody();
                msgForForward.setBody(body);
            }
            break;
            case COMBINE: {
                // send combine message
                EMCombineMessageBody body = (EMCombineMessageBody) message.getBody();
                msgForForward.setBody(body);
            }
            break;
            case IMAGE: {
                // send image
                EMImageMessageBody body = (EMImageMessageBody) message.getBody();
                msgForForward.setBody(body);
            }
            break;
            case VIDEO: {
                // send image
                EMVideoMessageBody body = (EMVideoMessageBody) message.getBody();
                msgForForward.setBody(body);
            }
            break;

            case FILE: {
                // send image
                EMFileMessageBody body = (EMFileMessageBody) message.getBody();
                msgForForward.setBody(body);
            }
            break;
            case VOICE:{
                // send image
                EMVoiceMessageBody body = (EMVoiceMessageBody) message.getBody();
                msgForForward.setBody(body);
            }
            break;
        }

        msgForForward.setMessageStatusCallback(new EMCallBack() {
            @Override
            public void onSuccess() {
                EMLog.e(TAG,"=====onSuccess==");
            }

            @Override
            public void onError(int code, String error) {
                EMLog.d(TAG, "===onError===code: " + code + " error: " + error);
            }

            @Override
            public void onProgress(int progress, String status) {

            }
        });
        // send message
        EMClient.getInstance().chatManager().sendMessage(msgForForward);

2.接收方在EMMessageListener#onMessageReceived里接收消息；

代码如下：

EMMessageListener msgListener = new EMMessageListener() {

              //接收到消息
            @Override
            public void onMessageReceived(List<EMMessage> messages) {
            }

        };
        //注册消息监听
  EMClient.getInstance().chatManager().addMessageListener(msgListener);

注意事项 :

转发附件类消息报下图错误时（视频消息除外），先检查引入的环信SDK版本，这个功能需要使用4.4.0以上的SDK版本；
转发图片消息时，接收方收到图片后，调用EMClient.getInstance().chatManager().downloadThumbnail(message)下载本地后，对比原图模糊时，请检发送方在发送图片时，是否有压缩？
代码如下：
转发COMBINE消息时，遇到下图报错，请检查引入的环信SDK版本（需要使用4.4.0以上包含4.4.0的sdk版本）

二. 合并转发消息

1. 创建和发送合并消息

注：合并消息的原始消息 ID 列表。该列表最多包含 300 个消息 ID。

String title = "标题";
        String summary = "合并消息的概要";
        String compatibleText = "您当前的版本不支持该消息，请升级到最新版本";
        EMMessage message = EMMessage.createCombinedSendMessage(title, summary, compatibleText, mlisMsgID, username);
        message.setMessageStatusCallback(new EMCallBack() {
            @Override
            public void onSuccess() {
                // 消息发送成功的处理逻辑
                EMLog.e(TAG,"==onSuccess===");
            }

            @Override
            public void onError(int code, String error) {
                // 消息发送失败的处理逻辑
                EMLog.e(TAG,"==onError===code:"+code+",error:"+error);
            }
        });
        EMClient.getInstance().chatManager().sendMessage(message);

2. 解析合并消息

合并消息实际上是一种附件消息。收到合并消息后，你可以调用 downloadAndParseCombineMessage 方法下载合并消息附件并解析出原始消息列表。

EMMessageListener msgListener = new EMMessageListener() {

            @Override
            public void onMessageReceived(List<EMMessage> messages) {

                for (EMMessage emmessage:messages) {
//下载合并消息 EMClient.getInstance().chatManager().downloadAndParseCombineMessage(emmessage, new EMValueCallBack<List<EMMessage>>() {
                        @Override
                        public void onSuccess(List<EMMessage> value) {
                            // 处理并展示消息列表
                        }

                        @Override
                        public void onError(int error, String errorMsg) {
                            // 处理出错信息
                        }
                    });
                }
            }
        };
        //注册消息监听
        EMClient.getInstance().chatManager().addMessageListener(msgListener);