中秋禮物!開源即時通訊GGTalk安卓版全新原始碼!
經過連續兩個多月的努力(開發、除錯、測試、改bug),我們終於趕在中秋國慶之前能把全新的GGTalk Android版本獻給大家。
4年之前我們就推出了GGTalk Android的第一個版本,但是功能太簡單,介面很粗糙,程式碼也很糟糕。後面了,因為一直忙著做專案,也沒有太多時間去完善它。
很多使用GGTalk的朋友經常問新的Android版什麼時候出來,我們也是不好意思地一拖再拖,到了今年7月份,終於再也拖不下去了,必須要釋出一個功能相對完整的版本,才能對得住關注的朋友們。
終於,在今天GGTalk 7.0 對應的安卓全新版本終於和小夥伴們見面了,它與剛釋出的GGTalk 7.0 的PC客戶端可以是互通的,因此它當然也就可以與我們PC端相互通訊,相互聊天了。下面我們先來看看它的真面目吧!
( 想要直接下載GGTalk Android全新原始碼的朋友請點選:原始碼下載中心)
一、GGTalk 安卓版截圖
二、原始碼實現
接下來,我們概要的介紹一下GGTalk Android原始碼專案的結構,以及原始碼實現中比較重要和難以理解的部分,以方便大家能更快地上手GGTalk 安卓端原始碼。
1、專案結構
2、訊息傳送與接收
與服務端的通訊互動還是與PC端一致,都是採用的ESFramework的通訊框架來實現的。先建立一個客戶端客戶端引擎IRapidPassiveEngine,再呼叫引擎的initialize方法即可完成登入的操作。 程式碼如下
CustomizeHandler handler = new CustomizeHandler(); engine = RapidEngineFactory.CreatePassiveEngine(); engine.setEngineEventListener(GGApplication.getInstance()); engine.getBasicOutter().addBasicEventListener(GGApplication.getInstance()); LogonResponse resp = engine.initialize(getUserName, getPassWord, host, port, handler, getApplication());
登入成功後的訊息都是在GGApplication這個類中收到並處理,主要有如下2個回撥方法
/** * 對方通過engin.sendMessage()方法傳送的訊息,會進入到該回調中 * */ @Override public void messageReceived(String sourceUserID, int messageType, byte[] message, String tag) { switch (ContractType.getContractTypeByCode(messageType)) { case CHAT: try { RichChatMessage richChatMessage = new RichChatMessage(); richChatMessage.deserialize(BufferUtils.wrappedBuffer(message)); EventBus.getDefault().post(new ChatEvent(tag, tag, richChatMessage, false)); GGApplication.getInstance().ringForMessage(); } catch (Exception e) { e.printStackTrace(); } break; ... } /** * 對方通過engin.ICustomizeOutter.send()方法傳送的訊息,會進入到該回調中 * */ @Override public void handleInformation(String sourceUserID, int messageType, byte[] bytes) { try { switch (ContractType.getContractTypeByCode(messageType)) { case UserStatusChanged: UserStatusChangedContract userStatusChangedContract = new UserStatusChangedContract(); userStatusChangedContract.deserialize(bytes); EventBus.getDefault().post(new UserStatusChanagedEvent(userStatusChangedContract.getUserID(), userStatusChangedContract.getStatus())); break; ... }
傳送訊息方式同樣有2種:1. 直接通過engin.sendMessage,2.通過ICustomizeOutter介面傳送 它們呼叫的方式都大同小異, 我們就以第一種方式來做介紹
public void sendChatMessage(String targetUserID, RichChatMessage message) { byte[] msg = null; try { msg = message.serialize(); } catch (Exception ee) { ee.printStackTrace(); } this.engine.sendMessage(null, ContractType.CHAT.getType(), msg, targetUserID); }
void sendMessage(String targerID, int type, byte[] data, String tag);
第一個引數 targerID 為接收者ID(null 表示接收者為服務端),第二個引數type 為訊息型別,第三個引數data 為訊息內容 序列化後的資料,第四個引數tag為附帶的字串(可為空字串)
3、主要控制元件介紹
(1)視訊控制元件:CameraSurfaceView、OMCSSurfaceView。
CameraSurfaceView:主要功能是顯示本機的預覽介面,通過ICamOpenOverCallback介面的回撥注入到OMCS框架中
@Override public void cameraHasOpened() { try { //預覽camera所用holder,不可為null或是隱藏,否則不能從攝像頭獲取資料 SurfaceHolder holder = myView.getSurfaceHolder(); //觸發預覽事件 MultimediaManagerFactory.GetSingleton().startCameraPreview(holder); } catch (Exception ex) { ex.printStackTrace(); } }
OMCSSurfaceView:主要功能是連線對方的攝像頭並顯示影象。使用起來也比較簡單,我們只需要通過setOtherVideoPlayerSurfaceView將它注入到攝像頭聯結器CameraConnector 中就可以了,當cameraConnector呼叫其beginConnect方法時就會自動去連線對方的攝像頭,並將影象內容顯示到OMCSSurfaceView控制元件上。
CameraConnector cameraConnector = new CameraConnector(); OMCSSurfaceView otherView = (OMCSSurfaceView) findViewById(R.id.opposite_surface); cameraConnector.setOtherVideoPlayerSurfaceView(otherView); cameraConnector.setVideoUniformScale(true,true); cameraConnector.beginConnect(uerid);
(2)音訊聯結器 MicrophoneConnector
這個就比較簡單了,只需呼叫其beginConnect方法即可,這樣就可以連線到對方的麥克風,監聽對方的語音
MicrophoneConnector microphoneConnector = new MicrophoneConnector(); microphoneConnector.beginConnect(uerid);
(3)語音訊息 AudioMessage
首先是初始化,並註冊播放的回撥方法
@Override protected void onResume() { super.onResume(); if (!MultimediaManagerFactory.GetSingleton().getAudioMessageController().isInitialized()) { MultimediaManagerFactory.GetSingleton().getAudioMessageController().initialize(); MultimediaManagerFactory.GetSingleton().getAudioMessageController().setAudioMessageHandler(GGApplication.getInstance()); MultimediaManagerFactory.GetSingleton().getAudioMessageController().getAudioMessagePlayer().setAudioPlayerCallback(this); } } //region IAudioPlayerCallback 播放回調 @Override public void playFinished(AudioMessage message) { message.setAnimation(false); // Log.i("ChatLVAdapter", "playFinished:"+message); Message msg = mHandler.obtainMessage(1); mHandler.sendMessage(msg); } @Override public void playInterrupted(AudioMessage message) { message.setAnimation(false); // Log.i("ChatLVAdapter", "playInterrupted:"+message); Message msg = mHandler.obtainMessage(1); mHandler.sendMessage(msg); } //endregion
錄製和傳送語音訊息給對方,startCapture()方法開始採集,stopCapture()方法停止採集並返回已採集的AudioMessage物件,再通過send方法將 AudioMessage物件傳送給指定的好友。
if (event.getAction() == MotionEvent.ACTION_UP) { if (SDKUtil.checkConnection()) { AudioMessage message = MultimediaManagerFactory.GetSingleton().getAudioMessageController().stopCapture(); if (message != null) { //沒有一秒不傳送 if (message.spanInMSecs > 1000) { ChatInfo info = getChatInfo(GGApplication.getInstance().getMySelf().getUserID(), message, true); addChatinfoAndDisplay(info); MultimediaManagerFactory.GetSingleton().getAudioMessageController().send(message, TalkingID); } else { ToastUtils.showShort(ChatActivity.this.getApplication(), "時間太短!"); } } } buttonSpeak.setText("按住說話"); //發出採集資料,並展現再介面中 } else if (event.getAction() == MotionEvent.ACTION_DOWN) { if (SDKUtil.checkConnection()) { MultimediaManagerFactory.GetSingleton().getAudioMessageController().startCapture(); } buttonSpeak.setText("鬆開結束"); }
接收語音訊息,需要實現 IAudioMessageHandler 介面 ,並呼叫setAudioMessageHandler 方法注入到OMCS框架中,當收到其他好友發來的語音訊息時就會觸發 handleAudioMessage,我們只需在該方法內做相關接收訊息的處理即可。
public interface IAudioMessageHandler { void handleAudioMessage(AudioMessage var1); } @Override public void handleAudioMessage(AudioMessage message) { try { EventBus.getDefault().post(new ChatEvent(message.creatorID, message.creatorID, message, false)); GGApplication.getInstance().ringForMessage(); } catch (Exception e) { e.printStackTrace(); } }
MultimediaManagerFactory.GetSingleton().getAudioMessageController().setAudioMessageHandler(GGApplication.getInstance());
語音訊息的播放和停止,通過getAudioMessagePlayer()獲取播放器,呼叫其play或stop 方法即可完成播放語音和停止播放的功能
IAudioMessagePlayer audioPlayer=MultimediaManagerFactory.GetSingleton().getAudioMessageController().getAudioMessagePlayer(); audioPlayer.play(audioMessage); audioPlayer.stop();
語音訊息頁面關掉時,記住要釋放語音訊息控制器,不然會一直佔用麥克風
MultimediaManagerFactory.GetSingleton().getAudioMessageController().dispose();
三、GGTalk Android 原始碼下載
最新原始碼下載以及部署說明文件,請轉到這裡。
注意:全新的GGTalk Android原始碼,要配合最新的GGTalk 7.0(服務端+PC端),才可以正常互通的。
________________________________________________________________________
歡迎和我探討關於GGTalk的一切,我的QQ:2027224508,多多交流!
大家有什麼問題和建議,可以留言,也可以傳送email到我郵箱:[email protected]。
如果你覺得還不錯,請粉我,順便再頂一下啊
&n