从0开始，搭建一个完整的Android音视频通讯系统

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

1、准备:

首先在图鸭官网：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中操做类

 

2、操做类定义：

一、TYVoipAndroid：提供全部Voip相关方法

二、TYVoipVideoCapture：摄像头管理类

三、TYVoipVideoRender：Voip客户端视频渲染视图.，渲染在此视图上进行

 

了解上述主要接口文件及其定义后，咱们来了解SDK中的通讯原理：在SDK中，全部用户都以通信节点的形式存在，做为节点的用户都拥有本身惟一的表示—— UserID ，整个SDK会根据每一个用户的UserID来进行通信。

 

例如，甲和乙之间进行通信，假设甲的UserID为401，乙的UserID为402，甲登陆后向乙发送我要和你开视频，乙登陆后向甲发送我要和你开视频，甲开始渲染乙的视图，乙开始渲染甲的视图 。完成上述全部操做后，甲乙创建通信。

 

3、完整的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>根据具体的业务逻辑重复步骤三、四、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音视频通讯系统就完成了。