发送文本消息及表情
//获取到与聊天人的会话对象。参数username为聊天人的userid或者groupid,后文中的username皆是如此
EMConversation conversation = EMChatManager.getInstance().getConversation(username)
//创建一条文本消息
EMMessage message = EMMessage.createSendMessage(EMMessage.Type.TXT)
//如果是群聊,设置chattype,默认是单聊
message.setChatType(ChatType.GroupChat)
//设置消息body
TextMessageBody txtBody = new TextMessageBody(content)
message.addBody(txtBody)
//设置接收人
message.setReceipt(username)
//把消息加入到此会话对象中
conversation.addMessage(message)
//发送消息
EMChatManager.getInstance().sendMessage(message, new EMCallBack(){})
发送语音消息
EMConversation conversation = EMChatManager.getInstance().getConversation(username)
EMMessage message = EMMessage.createSendMessage(EMMessage.Type.VOICE)
//如果是群聊,设置chattype,默认是单聊
message.setChatType(ChatType.GroupChat)
VoiceMessageBody body = new VoiceMessageBody(new File(filePath), len)
message.addBody(body)
message.setReceipt(username)
conversation.addMessage(message)
EMChatManager.getInstance().sendMessage(message, new EMCallBack(){})
发送图片消息
EMConversation conversation = EMChatManager.getInstance().getConversation(username)
EMMessage message = EMMessage.createSendMessage(EMMessage.Type.IMAGE)
//如果是群聊,设置chattype,默认是单聊
message.setChatType(ChatType.GroupChat)
ImageMessageBody body = new ImageMessageBody(new File(filePath))
// 默认超过100k的图片会压缩后发给对方,可以设置成发送原图
// body.setSendOriginalImage(true)
message.addBody(body)
message.setReceipt(username)
conversation.addMessage(message)
EMChatManager.getInstance().sendMessage(message, new EMCallBack(){})
发送地理位置消息
EMConversation conversation = EMChatManager.getInstance().getConversation(username)
EMMessage message = EMMessage.createSendMessage(EMMessage.Type.LOCATION)
//如果是群聊,设置chattype,默认是单聊
message.setChatType(ChatType.GroupChat)
LocationMessageBody locBody = new LocationMessageBody(locationAddress, latitude, longitude)
message.addBody(locBody)
message.setReceipt(username)
conversation.addMessage(message)
EMChatManager.getInstance().sendMessage(message, new EMCallBack(){})
发送文件消息
EMConversation conversation = EMChatManager.getInstance().getConversation(username)
// 创建一个文件消息
EMMessage message = EMMessage.createSendMessage(EMMessage.Type.FILE)
// 如果是群聊,设置chattype,默认是单聊
if (chatType == CHATTYPE_GROUP)
message.setChatType(ChatType.GroupChat)
//设置接收人的username
message.setReceipt(username)
// add message body
NormalFileMessageBody body = new NormalFileMessageBody(new File(filePath))
message.addBody(body)
conversation.addMessage(message)
EMChatManager.getInstance().sendMessage(message, new EMCallBack(){})
接收消息
通过广播接收新消息
注意事项:为了防止新消息来时,因为没有注册广播接收者,导致漏接消息的情况,注册完接受者以及好友监听等事件后,需要调用以下 SDK 才会发送新消息的广播,只需调用一次即可,可参考 Demo 的 mainactivity。
EMChat.getInstance().setAppInited()
另外,当 APP 在后台时,SDK 默认以 notification 的形式通知有新消息,不会走广播,如果需要走广播,可以调用以下 SDK 关闭 notification 通知,这样新消息还是走发送广播的形式。
EMChatManager.getInstance().getChatOptions().setShowNotificationInBackgroud(false)
注册一个相应 broadcast,用来接收消息。
NewMessageBroadcastReceiver msgReceiver = new NewMessageBroadcastReceiver()
IntentFilter intentFilter = new IntentFilter(EMChatManager.getInstance().getNewMessageBroadcastAction())
intentFilter.setPriority(3)
registerReceiver(msgReceiver, intentFilter)
private class NewMessageBroadcastReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
//消息id
String msgId = intent.getStringExtra("msgid")
//发消息的人的username(userid)
String msgFrom = intent.getStringExtra("from")
//消息类型,文本、图片、语音消息等,这里返回的值为msg.type.ordinal()。
//所以消息type实际为是enum类型
int msgType = intent.getIntExtra("type", 0)
Log.d("main", "new message id:" + msgId + " from:" + msgFrom + " type:" + msgType)
//更方便的方法是通过msgId直接获取整个message
EMMessage message = EMChatManager.getInstance().getMessage(msgId)
}
}
通过监听事件来接收新消息
注意事项:注册消息事件监听,此 listener 会收到所有类型的 event 事件,如果对某种或某些类型的事件感兴趣,可以用 registerEventListener(EMEventListener listener, EMNotifierEvent.EventType[] types)。
EMNotifierEvent.Event.EventDeliveryAck//已发送回执event注册
EMNotifierEvent.Event.EventNewCMDMessage//接收透传event注册
EMNotifierEvent.Event.EventNewMessage//接收新消息event注册
EMNotifierEvent.Event.EventOfflineMessage//接收离线消息event注册
EMNotifierEvent.Event.EventReadAck//已读回执event注册
EMNotifierEvent.Event.EventConversationListChanged//通知会话列表通知event注册(在某些特殊情况,SDK去删除会话的时候会收到回调监听)
接收所有的 event 事件:
EMChatManager.getInstance().registerEventListener(new EMEventListener() {
@Override
public void onEvent(EMNotifierEvent event) {
// TODO Auto-generated method stub
EMMessage message = (EMMessage) event.getData()
}
})
有选择性的接收某些类型 event 事件:
EMChatManager.getInstance().registerEventListener(new EMEventListener() {
@Override
public void onEvent(EMNotifierEvent event) {
// TODO Auto-generated method stub
EMMessage message = (EMMessage) event.getData()
}
}, new EMNotifierEvent.Event[]{EMNotifierEvent.Event.EventNewMessage,.......}
)
注:广播和监听事件不可同时混用。
解除监听事件
如果不想收到回调,则执行解除监听事件。
EMChatManager.getInstance().unregisterEventListener(new EMEventListener() {
@Override
public void onEvent(EMNotifierEvent event) {
// TODO Auto-generated method stub
}
})
获取聊天记录
EMConversation conversation = EMChatManager.getInstance().getConversation(username|groupid)
//获取此会话的所有消息
List<EMMessage>messages = conversation.getAllMessages()
//sdk初始化加载的聊天记录为20条,到顶时需要去db里获取更多
//获取startMsgId之前的pagesize条消息,此方法获取的messages sdk会自动存入到此会话中,app中无需再次把获取到的messages添加到会话中
List<EMMessage>messages = conversation.loadMoreMsgFromDB(startMsgId, pagesize)
//如果是群聊,调用下面此方法
List<EMMessage>messages = conversation.loadMoreGroupMsgFromDB(startMsgId, pagesize)
消息管理(单一聊天人、所有聊天人)
获取未读消息数量
EMConversation conversation = EMChatManager.getInstance().getConversation(username|groupid)
conversation.getUnreadMsgCount()
未读消息数清零
指定会话消息未读数清零。
EMConversation conversation = EMChatManager.getInstance().getConversation(username|groupid)
conversation.markAllMessagesAsRead()
所有未读消息数清零
EMChatManager.getInstance().markAllConversationsAsRead()
获取消息总数
EMConversation conversation = EMChatManager.getInstance().getConversation(username|groupid)
conversation.getMsgCount()
清空会话聊天记录
//清空和某个user的聊天记录(包括本地),不删除conversation这个会话对象
EMChatManager.getInstance().clearConversation(username|groupid)
删除单个聊天记录
//删除和某个user的整个的聊天记录(包括本地)
EMChatManager.getInstance().deleteConversation(username|groupid)
//删除当前会话的某条聊天记录
EMConversation conversation = EMChatManager.getInstance().getConversation(username|groupid)
conversation.removeMessage(deleteMsg.msgId)
删除所有聊天记录
//删除所有会话记录(包括本地)
EMChatManager.getInstance().deleteAllConversation()
设置某条消息为已读
//markAsRead为true,则标记msgid的消息位已读
conversation.getMessage({msgid},markAsRead)
设置自定义的消息提示
APP 在后台时,新消息会通过 notification 的方式,在手机状态栏提示新消息,可以把提示的内容换成自定义的内容(在application的oncreate()里设置)。
//获取到配置options对象
EMChatOptions options = EMChatManager.getInstance().getChatOptions()
//设置自定义的文字提示
options.setNotifyText(new OnMessageNotifyListener() {
@Override
public String onNewMessageNotify(EMMessage message) {
//可以根据message的类型提示不同文字,这里为一个简单的示例
return "你的好基友" + message.getFrom() + "发来了一条消息哦"
}
@Override
public String onLatestMessageNotify(EMMessage message, int fromUsersNum, int messageNum) {
return fromUsersNum + "个基友,发来了" + messageNum + "条消息"
}
})
设置自定义 notification 点击跳转 intent。
用户点击 notification 消息,SDK 会有默认的跳转 intent,开发者可以设置自己的跳转 intent,这里以 UIdemo 的代码为例。
// 获取到EMChatOptions对象
EMChatOptions options = EMChatManager.getInstance().getChatOptions()
//设置notification点击listener
options.setOnNotificationClickListener(new OnNotificationClickListener() {
@Override
public Intent onNotificationClick(EMMessage message) {
Intent intent = new Intent(applicationContext, ChatActivity.class)
ChatType chatType = message.getChatType()
if(chatType == ChatType.Chat){ //单聊信息
intent.putExtra("userId", message.getFrom())
intent.putExtra("chatType", ChatActivity.CHATTYPE_SINGLE)
}else{ //群聊信息
//message.getTo()为群聊id
intent.putExtra("groupId", message.getTo())
intent.putExtra("chatType", ChatActivity.CHATTYPE_GROUP)
}
return intent
}
})
新消息提示
SDK 中提供了方便的新消息提醒功能。可以在收到消息时调用,提醒用户有新消息。
首先获取EMChatOptions。
chatOptions = EMChatManager.getInstance().getChatOptions()
设置是否启用新消息提醒(打开或者关闭消息声音和震动提示)。
chatOptions.setNotifyBySoundAndVibrate(true|false)//默认为true 开启新消息提醒
设置是否启用新消息声音提醒。
chatOptions.setNoticeBySound(true|false)//默认为true 开启声音提醒
设置是否启用新消息震动提醒。
chatOptions.setNoticedByVibrate(true|false)//默认为true 开启震动提醒
设置语音消息播放是否设置为扬声器播放。
chatOptions.setUseSpeaker(true|false)//默认为true 开启扬声器播放
设置后台接收新消息时是否通过通知栏提示。
chatOptions.setShowNotificationInBackgroud(true|false) //默认为true
附:
chatOptions.setAcceptInvitationAlways(false)
//默认添加好友时为true,是不需要验证的,改成需要验证为false
1.首先环信聊天是不支持头像跟昵称管理的,所以要想办法把昵称跟头像放在自己的服务器上来管理
只需要更改两处就可以解决了,只需要跟搞安卓协商好这两个Key就可以很好的完成安卓跟iOS互相聊天是显示昵称跟头像了.
前提把环信SDK和EaseUI成功集成后,我集成的环信SDK版本是2.x,EaseUI版本是3.x,效果图如下:
1、 环信EaseUI提供的API的实现
2、对环信得方法进行重写
欢迎分享,转载请注明来源:内存溢出
评论列表(0条)