项目源码请参考 Android-IM
项目服务端使用极光JMessage

对话撤回的效果图:

null

这里只是在对话的界面展示了撤回消息的处理。
其实还有一个地方,是会话列表,也需要动态展示撤回消息的通知。

先说对话列表要进行的操作

  • 发送方:点击撤回事件,本地视图移除,通知服务端更新
  • 接收方:动态获取消息,当获取到撤回消息事件,移除视图。

然后是会话列表也要同步展示

  • 会话列表只有一个接收方,需要在接收到撤回消息的事件更新视图

具体实现

发送方撤回

只能是发送方才可以撤回

1、首先获取当前聊天的会话

position这里是从上个页面传递的数据,上个页面是指会话列表的索引。Conversation就是当前的会话。
JMessageClient.getConversationList()是获取所有的会话列表。

Conversation conversation=JMessageClient.getConversationList().get(position);

2、创建撤回事件

这个事件就是通知服务端的撤回消息。
两个参数分别是(需要撤回的消息,服务端返回的结果)。其中Message在长按消息的时候就给返回了,只需获取消息就可以了。
conversation.retractMessage(message.getMessage(), new BasicCallback())

3、接收到撤回成功的事件

当服务器返回撤回成功的事件(i==0)后,通过

//移除当前item
mAdapter.deleteById(message.getMsgId());
//添加一条撤回的item
mAdapter.addToStart(new MyMessage("[你撤回了一条消息]", SEND_TEXT),true);
//更新视图
mAdapter.notifyDataSetChanged();

new MyMessage第二个参数是消息类型

完整代码:

//
conversation.retractMessage(message.getMessage(), new BasicCallback() {
    @Override
    public void gotResult(int i, String s) {
        if (i==0){
            showToast(ChatMsgActivity.this,"撤回了一条消息");
            mAdapter.deleteById(message.getMsgId());
            mAdapter.addToStart(new MyMessage("[你撤回了一条消息]", SEND_TEXT),true);
            mAdapter.notifyDataSetChanged();
        }else {
            showToast(ChatMsgActivity.this,"撤回失败:"+s);
        }
    }
});
获取对方的撤回事件

撤回的目的就是为了让对方看不到,而我们作为发送方,当收到对方的消息之后,默认是直接在对话窗口展示的。但是这时候对方突然撤回了消息,我们也需要在对话窗口移除掉消息。

1、注册消息接收者

所有的通知,消息都需要注册。包括消息事件、撤回事件、好友请求事件等等。
注册的方法是在onCreate中,一般在android开发中会定义一个BaseActivity的基类
或者单独的Activity中也一样,添加:
JMessageClient.registerEventReceiver(this);
这里有个需要注意的是收到消息的时候,通知栏也会显示消息,所以如果是在对话界面,需要关闭通知栏的通知:
userName就是当前对话的对方的用户名,一般在上个页面通过数据传递的方式获取
JMessageClient.enterSingleConversation(userName);

2、接收撤回消息

onEvent是为了方便JMessage识别的方法,是固定的,里面的参数如果是接收撤回的消息就是MessageRetractEvent,如果是正常的会话消息就是MessageEvent,当然还有好友请求的消息ContactNotifyEvent等等。具体可以去查看api文档。

由于这个是独立的类,在移除视图的时候需要我们传一个消息id。
这个id的获取也需要在两个地方获取:
a) 在加载消息列表的时候,我们要把筛选出来正常的消息(非撤回)设置id。
b) 在接收到新消息时,也需要我们获取id。
需要注意的是被撤回的消息是没有ID的,不能再次被撤回
msgID = myMessage.getMsgId();

移除完视图之后,可以选择再添加一个新的撤回消息的视图

mAdapter.addToStart(new MyMessage("[对方撤回了一条消息]", IMessage.MessageType.RECEIVE_TEXT),true);

这里new MyMessage的第二个参数就需要改变为对方的类型了。
在加载消息列表的时候也是通过该方法来判断消息展示的左右位置。

完整代码:

    /*接收到撤回的消息*/
    public void onEvent(MessageRetractEvent event){
        runOnUiThread(new Runnable() {
            @Override
            public void run() {
                mAdapter.deleteById(msgID);
                mAdapter.addToStart(new MyMessage("[对方撤回了一条消息]", IMessage.MessageType.RECEIVE_TEXT),true);
                mAdapter.notifyDataSetChanged();
            }

        });

    }

3、注销消息接收者、退出会话

在onDestroy中

   @Override
    protected void onDestroy() {
         //接收事件解绑
        JMessageClient.unRegisterEventReceiver(this);
        //退出会话
        JMessageClient.exitConversation();
        super.onDestroy();
    }

上面就完成了对话消息列表的撤回处理。
接下来还有个地方需要处理。

会话列表接收撤回

效果图:
null
上面提到过JMessageClient.getConversationList()是获取会话列表的方法,也就是当前页面展示的内容。
该方法是封装后存在于本地的,所以不需要做进一步的处理。
只是加载后做进一步的解析-展示处理就行了。

1、解析会话列表

解析相对于来说比较简单,解析需要的实体类可以自己创建。将需要用到的参数解析出来就可以了。
在接收到撤回消息的时候或者其他消息,需要我们刷新数据。

这里需要注意的是在解析消息的时候,要对其做判断,由于目前只设置了文字消息和撤回消息两种,所以暂时只对这两种消息做了额外的处理。
后期还需要对图片消息,语音消息等做进一步的判断。

getLatestMessage()是获取最后一条消息的意思。

if (list.get(i).getLatestMessage().getContent().getContentType()== ContentType.prompt) {
                        bean.setContent(((PromptContent) (list.get(i).getLatestMessage()).getContent()).getPromptText());
                    }else {
                        bean.setContent(((TextContent) (list.get(i).getLatestMessage()).getContent()).getText());
                    }

部分代码:


for (int i = 0; i < list.size(); i++) {
                bean = new MessageBean();
                try {
                    //这里进行撤回消息的判断
//                    Log.e("type", list.get(i).getTitle()+","+list.get(i).getLatestMessage().getContent().getContentType());
                    if (list.get(i).getLatestMessage().getContent().getContentType()== ContentType.prompt) {
                        bean.setContent(((PromptContent) (list.get(i).getLatestMessage()).getContent()).getPromptText());
                    }else {
                        bean.setContent(((TextContent) (list.get(i).getLatestMessage()).getContent()).getText());
                    }
                } catch (Exception e) {
                        bean.setContent("最近没有消息!");
                    Log.e("Exception:MessageFM", e.getMessage());
                }
                bean.setMsgID(list.get(i).getId());
                bean.setUserName(((UserInfo) list.get(i).getTargetInfo()).getUserName());
                bean.setTitle(list.get(i).getTitle());
                bean.setTime(list.get(i).getUnReadMsgCnt() + "");
                bean.setConversation(list.get(i));
//                Log.e("Log:Conversation", list.get(i).getAllMessage()+"");

                try {
                    bean.setImg(list.get(i).getAvatarFile().toURI() + "");
                } catch (Exception e) {
                }
                data.add(bean);
            }
        }

        mFragmentMainRf.setRefreshing(false);
        adapter.notifyDataSetChanged();

2、接收撤回消息

和前面接收消息的方法一样

    /*接收撤回消息*/
    public void onEvent(MessageRetractEvent event) {
        handler.postDelayed(new Runnable() {
            @Override
            public void run() {
                //重新加载数据
                updataData();
            }
        },500);
    }

总结

在做消息功能的时候,大多数都是参照文档来开发,所以做的时候,需要对相关的类有一定的了解。知道其用法。
而且会话也是一个即时通讯的最基础的功能。涉及的范围也比较广,目前项目只实现了文字的会话,更高级的对话方式还需要进一步的开发。

项目地址:https://github.com/wapchief/Android-IM

相关阅读推荐: