从0开始,搭建一个完整的Android音视频通信系统 顶 原

昨天,图鸭君给大家介绍了如何在iOS端搭建音视频通信系统,今天我就给大家介绍一下如何搭建一个完整的Android音视频通信系统。

一、准备:

首先在图鸭官网:http://tucodec.com 进行注册,获得SDK中所需要的AppKey、AppSecret,注册登录后如下图所示:

 图1  注册后获取AppKey、AppSecret

 

其次到开发者里选择下载android中所需SDK。

图2  SDK下载展示

 

最后解压,如下图所示:

 

图3  SDK解压后内容

voip_android_demo1.0是用于演示的demo,图鸭君也将要按照这个demo以及SDK开发文档进行讲解,打开resource资源文件,如图4所示:

图4  resource文件夹内容

 

将voip_android.aar提取出来导入到工程,里面包含了提供相关操作的java类以及so库,配置相关的环境。

 

导入”voip_android.aar”文件(如图5)

在“libs”文件夹下添加aar包,在build文件夹下添加:

repositories {
    flatDir {
         dirs 'libs'
    }
}

在dependencies下添加:

compile(name: 'voip_android', ext: 'aar')

 

配置其他三方库(如图5)

在gradle文件里面的dependencies 下添加下面三方库:

api "com.alibaba:fastjson:1.1.63.android"

 

加入权限

AndroidManifest.xml加入以下权限:

<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
<uses-permission android:name="android.permission.CAMERA"/>
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.READ_LOGS"/>
<uses-permission android:name="android.permission.RECORD_AUDIO"/>

      

   图5  gradle文件内容

 

完成上述操作后,我们的音视频通讯App所需的大体框架已经完成啦,之后就是码代码,完成系统UI界面绘制和用户之间通讯的逻辑操作。

在图鸭科技提供的SDK中,我们可以看到只需要调用三个类进行操作,可见快速集成音视频通信并不是那么复杂。如图6所示:

                        

图6  SDK中操作类

 

二、操作类定义:

1、TYVoipAndroid:提供所有Voip相关方法

2、TYVoipVideoCapture:摄像头管理类

3、TYVoipVideoRender:Voip客户端视频渲染视图.,渲染在此视图上进行

 

了解上述主要接口文件及其定义后,我们来了解SDK中的通信原理:SDK中,所有用户都以通讯节点的形式存在,作为节点的用户都拥有自己唯一的表示—— UserID ,整个SDK会根据每个用户的UserID来进行通讯。

 

例如,甲和乙之间进行通讯,假设甲的UserID为401,乙的UserID为402,甲登录后向乙发送我要和你开视频,乙登录后向甲发送我要和你开视频,甲开始渲染乙的视图,乙开始渲染甲的视图 。完成上述所有操作后,甲乙建立通讯。

 

三、完整的SDK使用步骤简介:

 

<1>初始化TYVoipAndroid、TYVoipVideoCapture类:

mTYVoipAndroid = new TYVoipAndroid(new Handler(), Context,null);

mVideoCapture = TYVoipVideoCapture(mTYVoipAndroid ,
           TYVoipVideoCapture.CaptureParam(mTYVoipAndroid.config.videoWidth,  

  mTYVoipAndroid.config.videoHeight));

 

<2>登录转发服务器(建议写成单例,一次登录,多次调用):

loginRelayServer(String ip, short port, int userId, int sessionId, int AppKey, int AppSecret);

 

<3>开启相机,注册音视频回调,初始化Voip客户端,开启传输

mVideoCapture.start(false, mTYVoipAndroid.config, mMainRender.parent    as   ViewGroup);

    mTYVoipAndroid.registerVideoCallback(mVideoCallback);

mTYVoipAndroid.registerAudioCallback(mAudioCallback);

mTYVoipAndroid.initVoip(mVideoCapture);

mTYVoipAndroid.startVoip(int videoBitRate, int audioBitRate, int userId);

 

<4>根据逻辑,添加(删除)需要通话的节点:

mTYVoipAndroid.addClientNode(int userId);

//mTYVoipAndroid.removeClientNode(int userId);

 

<5>不需要通话时,停止voip:

mTYVoipAndroid.stopCall()

//清空现有的连接节点(不再接收节点的数据)

mTYVoipAndroid.clearClientNodeList();

 

<6>根据具体的业务逻辑重复步骤3、4、5

 

<7>在程序结束时销毁voip

mTYVoipAndroid.release()

 

部分代码解释:(从用户甲的实现代码来解释)

 

private TYVoipVideoRender preView;    //渲染甲的视图

private TYVoipVideoRender otherView;  //渲染乙的视图

 

<1>登录操作:

   甲(UserID:401)登录操作,返回值为是否登录成功(非0即为成功):

 

/**

*连接转发服务器

*@param ip @param 端口号@param userId @param sessionId

*@param AppKey @param AppSecret @return !0即为成功

*/

mTYVoipAndroid.loginRelayServer(ip, port, 401, sessionId, AppKey,  AppSecret);

 

<2>连接操作

甲连接乙操作:

...一系列操作/

//甲自己加入到通讯中

mTYVoipAndroid.startVoip(512, 16000, 401);

//添加节点(添加乙的USerID)

mTYVoipAndroid.addClientNode(402);

 

//在videoCallBack上进行视图渲染

 

private TYVoipAndroid.VideoCallback mVideoCallback = new TYVoipAndroid.VideoCallback() {
    @Override
    public void renderVoipVideoData(VoipImage voipImage) {
        if (voipImage.isLocal){
        //本地视频渲染(甲的数据流)
        preView.pushVideoFrame(voipImage);
        }else {

//非本地视频渲染(乙的数据流)
          otherView.pushVideoFrame(voipImage);
        }
    }
};

//在audioCallBack回调方法目前还未用到,忽视此回调

 

<3>断开操作

甲进行断开通信操作

//停止相机视频捕捉

mVideoCapture.stop()

//清空现有的连接节点(不再接收节点的数据)

mTYVoipAndroid.clearClientNodeList();

//结束Voip通话
mTYVoipAndroid.stopCall()

//释放资源
mTYVoipAndroid.release()

项目中最重要的代码介绍完啦,那测试一下,看看我们的成果吧。

 

图7  测试效果图

 

达到上图所示结果,一套完整的android音视频通信系统就完成了。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章