項(xiàng)目源碼請參考 Android-IM
項(xiàng)目服務(wù)端使用極光JMessage
對話列表使用aurora-imui開源組件
簡介
imui
是極光在GitHub上開源的一個(gè)即時(shí)通訊庫，方便開發(fā)者快速使用，完成即時(shí)通訊類的對話展示。目前支持Android册养、iOS、React Native三大平臺。
該庫在Android端包括兩大控件
1.MessageList
展示的對話列表炉抒，支持自定義ViewHolder布局
導(dǎo)入方式：
compile 'cn.jiguang.imui:messagelist:0.4.6'
2.ChatInputView
消息輸入方式，比如語音稚叹，圖片焰薄，位置等
導(dǎo)入方式：
compile 'cn.jiguang.imui:chatinput:0.4.6'
JMessage
是極光提供的sdk服務(wù)，用于接收和轉(zhuǎn)發(fā)消息扒袖。也是項(xiàng)目中最重要的部分塞茅。
集成方式建議直接參考文檔，已經(jīng)很詳細(xì)了：JMessage Android SDK 集成指南
開始前的準(zhǔn)備
1.在布局中加入控件
關(guān)于一些常用的屬性季率，比如發(fā)送方或者接收方的字體大小顏色等野瘦，可以手動設(shè)置。
<cn.jiguang.imui.messages.MessageList
android:id="@+id/msg_list"
android:layout_width="match_parent"
android:layout_height="match_parent"
app:avatarHeight="48dp"
app:avatarWidth="48dp"
app:bubbleMaxWidth="0.70"
app:dateTextSize="14sp"
app:receiveBubblePaddingLeft="16dp"
app:receiveBubblePaddingRight="8dp"
app:receiveTextColor="#ffffff"
app:receiveTextSize="14sp"
app:sendBubblePaddingLeft="8dp"
app:sendBubblePaddingRight="16dp"
app:sendTextColor="#7587A8"
app:sendTextSize="14sp" />
2.創(chuàng)建消息實(shí)體MyMessage
展示和解析消息的類飒泻，必須要實(shí)現(xiàn)IMessage接口鞭光。
因?yàn)檫@里需要解析極光服務(wù)端的消息，所以需要添加一個(gè)內(nèi)部Message的解析泞遗。
public class MyMessage implements IMessage {
private long id;
private String text;
private String timeString;
private MessageType type;
private IUser user;
private String mediaFilePath;
private long duration;
private String progress;
private Message message;
private int position;
private long msgID;
public MyMessage(String text, MessageType type) {
this.text = text;
this.type = type;
this.id = UUID.randomUUID().getLeastSignificantBits();
}
......
//省略get惰许、set方法
}
3.實(shí)現(xiàn)IUser接口
用戶頭像，id史辙，用戶名等參數(shù)
public class DefaultUser implements IUser {
private String id;
private String displayName;
private String avatar;
public DefaultUser(String id, String displayName, String avatar) {
this.id = id;
this.displayName = displayName;
this.avatar = avatar;
}
創(chuàng)建消息
這里的創(chuàng)建消息并不是單單指消息的發(fā)送汹买，包括消息的接收，展示等都需要手動去創(chuàng)建消息聊倔，以便于展示晦毙。
其實(shí)消息列表就是由多個(gè)MyMessage得到的。
1.創(chuàng)建展示的消息
創(chuàng)建消息需要兩個(gè)參數(shù)方库，一個(gè)是要展示的消息類型：
另一個(gè)參數(shù)是設(shè)置發(fā)送方或者接收方的位置和類型
MyMessage myMessage = new MyMessage(((TextContent) message.getContent()).getText(), IMessage.MessageType.RECEIVE_TEXT);
由于不同的類型需要不同的解析结序，所以如果類型出錯就會崩潰。
2.創(chuàng)建展示的對話用戶信息
setUserInfo需要一個(gè)IUser的參數(shù)類型纵潦。
DefaultUser需要的參數(shù)分別是當(dāng)前登錄的用戶名徐鹤、顯示的名稱、頭像
myMessage.setUserInfo(new DefaultUser(JMessageClient.getMyInfo().getUserName(), "DeadPool", imgRecrive));
發(fā)送消息
注意要區(qū)分Message和MyMessage：
Message是用來上傳邀层，發(fā)送消息的返敬，是sdk指定的唯一消息類型。
而MyMessage是UI指定的消息類寥院，所以兩者之間需要經(jīng)常轉(zhuǎn)換劲赠。
private void sendMessage(String msg) {
//創(chuàng)建文本消息
TextContent content = new TextContent(msg);
//獲取創(chuàng)建的消息
Message message1 = conversation.createSendMessage(content);
//創(chuàng)建展示的本地消息
final MyMessage myMessage = new MyMessage(msg, SEND_TEXT);
myMessage.setMessage(message1);
myMessage.setTimeString(TimeUtils.ms2date("MM-dd HH:mm", message1.getCreateTime()));
myMessage.setUserInfo(new DefaultUser(JMessageClient.getMyInfo().getUserName(), "DeadPool", imgSend));
//返回的結(jié)果
message1.setOnSendCompleteCallback(new BasicCallback() {
@Override
public void gotResult(int i, String s) {
if (i == 0) {
//將消息添加到本地視圖
mAdapter.addToStart(myMessage, true);
mChatEt.setText("");
} else {
}
}
});
//向服務(wù)器發(fā)送消息
JMessageClient.sendMessage(message1);
adapter不需要手動創(chuàng)建只需在開始的時(shí)候調(diào)用：
username：當(dāng)前用戶名
holder：自定義的viewholder，為空則使用默認(rèn)的布局
iamge：當(dāng)前的用戶頭像（發(fā)送方）
MsgListAdapter adapter = new MsgListAdapter<>(userName, holdersConfig, imageLoader);
messageList.setAdapter(adapter);
接收消息
onEvent是固定的寫法，參數(shù)有幾種類型
MessageEvent只負(fù)責(zé)接收消息事件凛澎。
比如消息撤回事件就是MessageRetractEvent霹肝。
但是都需要先通過Message解析消息，然后再使用MyMessage解析到本地塑煎，用于UI的展示
/*接收到的消息*/
public void onEvent(MessageEvent event) {
final Message message = event.getMessage();
runOnUiThread(new Runnable() {
@Override
public void run() {
//創(chuàng)建一個(gè)消息對象
MyMessage myMessage = new MyMessage(((TextContent) message.getContent()).getText(), IMessage.MessageType.RECEIVE_TEXT);
myMessage.setMessage(message);
myMessage.setMsgID(message.getServerMessageId());
myMessage.setText(((TextContent) message.getContent()).getText() + "");
myMessage.setTimeString(TimeUtils.ms2date("MM-dd HH:mm", message.getCreateTime()));
myMessage.setUserInfo(new DefaultUser(JMessageClient.getMyInfo().getUserName(), "DeadPool", imgRecrive));
if (message.getContentType() == ContentType.text || message.getContentType().equals("text")) {
mAdapter.addToStart(myMessage, true);
mAdapter.notifyDataSetChanged();
}
//收到消息時(shí)沫换，添加到集合
list.add(myMessage);
}
});
}
其它消息事件：
比如全局監(jiān)聽重復(fù)登錄事件，需要在根Activity處理最铁。
監(jiān)聽事件
1.點(diǎn)擊頭像的監(jiān)聽
setOnAvatarClickListener是封裝在Messagelist控件里的方法讯赏，可以直接拿來用。
一般分為兩種冷尉，發(fā)送方的頭像和接收方的頭像
在執(zhí)行相應(yīng)跳轉(zhuǎn)的時(shí)候要進(jìn)行消息方的判斷漱挎。
//點(diǎn)擊頭像
mAdapter.setOnAvatarClickListener(new MsgListAdapter.OnAvatarClickListener<MyMessage>() {
@Override
public void onAvatarClick(MyMessage message) {
DefaultUser userInfo = (DefaultUser) message.getFromUser();
Intent intent;
if (message.getType() == SEND_TEXT) {
intent = new Intent(mContext, UserActivty.class);
} else {
intent = new Intent(mContext, UserInfoActivity.class);
intent.putExtra("USERNAME", userName);
}
Log.e("userName", userInfo + "\n" + userName);
startActivity(intent);
}
});
2.單擊消息
單擊消息事件，可以選擇查看大圖或者播放視頻雀哨，播放語音文件等操作
mAdapter.setOnMsgClickListener(new MsgListAdapter.OnMsgClickListener<MyMessage>() {
@Override
public void onMessageClick(MyMessage message) {
// do something
showToast(ChatMsgActivity.this, "點(diǎn)擊了消息");
}
});
3.長按消息
一般長按消息磕谅，會選擇一些復(fù)制、刪除雾棺、撤回等功能怜庸。
復(fù)制：在復(fù)制的時(shí)候要先判斷消息類型，如果不是TEXT類型是無法復(fù)制的垢村。
刪除：刪除需要提交消息id到服務(wù)端，并且移除本地視圖嚎卫，更新UI嘉栓。兩行代碼就可以完成操作。
conversation.deleteMessage(new Integer(message.getMsgId()));
//移除視圖
mAdapter.deleteById(message.getMsgId());
撤回：跟刪除類似拓诸，不過刪除只是本地看不到侵佃，撤回需要接收撤回事件，防止消息撤回還能看到奠支，詳細(xì)操作請參考Android-IM即時(shí)通訊關(guān)于消息撤回的處理
//長按消息
mAdapter.setMsgLongClickListener(new MsgListAdapter.OnMsgLongClickListener<MyMessage>() {
@Override
public void onMessageLongClick(final MyMessage message) {
}
完整代碼還請參考項(xiàng)目
項(xiàng)目地址：https://github.com/wapchief/Android-IM
相關(guān)文章推薦
