中秋禮物！開源即時通訊GGTalk安卓版全新原始碼！

C#開源即時通訊GGTalk發表於2020-09-30

安卓原始碼

經過連續兩個多月的努力（開發、除錯、測試、改bug），我們終於趕在中秋國慶之前能把全新的GGTalk Android版本獻給大家。

4年之前我們就推出了GGTalk Android的第一個版本，但是功能太簡單，介面很粗糙，程式碼也很糟糕。後面了，因為一直忙著做專案，也沒有太多時間去完善它。

很多使用GGTalk的朋友經常問新的Android版什麼時候出來，我們也是不好意思地一拖再拖，到了今年7月份，終於再也拖不下去了，必須要釋出一個功能相對完整的版本，才能對得住關注的朋友們。

終於，在今天GGTalk 7.0 對應的安卓全新版本終於和小夥伴們見面了，它與剛釋出的GGTalk 7.0 的PC客戶端可以是互通的，因此它當然也就可以與我們PC端相互通訊，相互聊天了。下面我們先來看看它的真面目吧！

（想要直接下載GGTalk Android全新原始碼的朋友請點選：原始碼下載中心）

一、GGTalk 安卓版截圖

　　中秋禮物！開源即時通訊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到我郵箱：2027224508@qq.com。

如果你覺得還不錯，請粉我，順便再頂一下啊

中秋禮物！開源即時通訊GGTalk安卓版全新原始碼！

一、GGTalk 安卓版截圖

二、原始碼實現

1、專案結構

2、訊息傳送與接收

3、主要控制元件介紹

（1）視訊控制元件：CameraSurfaceView、OMCSSurfaceView。

（2）音訊聯結器 MicrophoneConnector

（3）語音訊息 AudioMessage

三、GGTalk Android 原始碼下載

相關文章