手把手教你，搭建一個完整的iOS音視頻通訊系統

如今市面上有許多音視頻通訊軟件，好比Facetime。你是否想過開發一款獨屬於本身的音視頻通訊軟件？在iOS開發中，音視頻通信開發一直比較困難：昂貴的開發成本、較高的技術門檻讓不少開發者和公司望而卻步。

 

今天圖鴨君就和你說一下，如何從0開始，搭建一個完整的iOS音視頻通訊系統。文中涉及的服務器配置問題，能夠到圖鴨官網查看相關文檔。

 

一、準備:

首先在圖鴨官網：http://tucodec.com 進行註冊，得到SDK中所須要的AppKey、AppSecret，註冊登陸後以下圖所示：

 圖1  註冊後獲取AppKey、AppSecret

 

其次到開發者裏選擇下載iOS中所需SDK。

 

圖2  SDK下載展現

 

最後解壓，以下圖所示：

圖3  SDK解壓後內容

 

解壓voipDemo.zip，如圖4所示：

 

圖4  voipDemo解壓後內容

 

把TYVoIPiOSSDK.framework拿出來，該framework即爲圖鴨音視頻SDK,導入到所需的iOS項目中,有時候導入framework工程沒有自動添加該SDK的framework路徑，檢查方法:target—>Build Settings—>Search Path,在Framework Search Path中加入TYVoIPiOSSDK.framework的路徑。因爲SDK是與C++混編的,因此只要使用到SDK中文件的 .m 文件都須要改爲 .mm 後綴名，如圖5所示：

 

圖5  SDK導入項目中展現圖

 

在使用TYVoIPiOSSDK.framework庫的時候，須要導入下面這些框架：

 

圖6  SDK所依賴庫展現

 

完成上述操做後，咱們的音視頻通信App所需的大致框架已經完成啦。

以後就是碼代碼，完成系統UI界面繪製和用戶之間通信的邏輯操做。

在圖鴨科技提供的SDK中，咱們能夠看到對外只有兩個頭文件，可見快速集成音視頻通訊並非那麼複雜。如圖7所示：

 

圖7  SDK中頭文件展現

 

2、頭文件定義：

 

<一> TYVoipDarwinManager.h文件，該文件定義了對外提供的類和協議。如下3個是該文件中核心類與協議。

(1) TYVoipDarwinManager : VoIP主要功能以及管理類

(2) TYVoipVideoData : 接收以及發送視頻數據模型

(3) TYVoipDelegate : VoIP的代理

 

<二> TYVoipRender.h文件：提供渲染用戶視圖View。

 

 

瞭解上述主要接口文件及其定義後，咱們來了解SDK中的通訊原理：在SDK中，全部用戶都以通信節點的形式存在，做爲節點的用戶都擁有本身惟一的表示—— UserID ，整個SDK會根據每一個用戶的UserID來進行通信。

 

例如，甲和乙之間進行通信，假設甲的UserID爲401，乙的UserID爲402，甲登陸後向乙發送我要和你開視頻，乙登陸後向甲發送我要和你開視頻，甲開始渲染乙的視圖，乙開始渲染甲的視圖 。完成上述全部操做後，甲乙創建通信。

 

3、完整的SDK使用步驟簡介:

<一>配置voip,在程序啓動的時候調用:

[[TYVoipManager share] configVoip];

 

<二>登陸轉發服務器(登陸一次便可):

[[TYVoipDarwinManager sharedVoip]  loginRelayServer:ip

serverPort:port

                               sessionId:sessionId

                              userId:_401

                                  AppKey:AppKey

                              AppSecret:AppSecret];

 <三>設置voip代理和開始voip:

     [[TYVoipDarwinManager sharedVoip] setDelegate:self];

  [[TYVoipDarwinManager sharedVoip] startCallWithUserId:401];

 

<四>根據邏輯,添加(刪除)須要通話的節點:

  [[TYVoipDarwinManager sharedVoip] addClientNode:402];

  //[[TYVoipDarwinManager sharedVoip] removeClientNode:402];

 

<五>不須要通話時,中止voip:

  //關閉voip

       [[TYVoipDarwinManager sharedVoip] stopCall];

  //清空現有的鏈接節點(再也不接收節點的數據)

       [[TYVoipDarwinManager sharedVoip] clearClientNodeList];

 

 <六>根據具體的業務邏輯重複步驟3、4、五

 

<七>在程序結束時銷燬voip

  [[TYVoipDarwinManager sharedVoip] destroy];

 

四、部分代碼解釋：（從用戶甲的實現代碼來解釋）

TYRenderView * preView;    //渲染甲的視圖

TYRenderView * otherView;   //渲染乙的視圖

 

<一>登陸操做：

   甲（UserID：401）登陸操做,返回值爲是否登陸成功(非0即爲成功):

-(BOOL)login{

         NSString * ip = @"**.**.**.**";//所需轉發服務器地址 

        uint16_t port = 0;

         int sessionId = 0;

         uint32_t AppKey = 0;//填寫剛纔申請的AppKey與AppSecret

         uint32_t AppSecret = 0;

  int res = [[TYVoipDarwinManager sharedVoip]  loginRelayServer:ip

serverPort:port

                               sessionId:sessionId

                              userId:_401

                                  AppKey:AppKey

                              AppSecret:AppSecret];

         return res;

}

<二>鏈接操做

甲鏈接乙操做：

-(void)startVoip{

//設置通信中所需代理     涉及到實現的方法下面有解釋

     [[TYVoipDarwinManager sharedVoip] setDelegate:self];

     //甲本身加入到通信中

  [[TYVoipDarwinManager sharedVoip] startCallWithUserId:401];

     //添加節點（添加乙的USerID）

     [[TYVoipDarwinManager sharedVoip] addClientNode:402];

     //視圖渲染

     [self.preView startRendering];//渲染甲本身

    [self.otherView startRendering];//渲染乙視圖

}

<三>斷開操做

甲進行斷開通訊操做

-(void)stopVoip{

     //關閉voip

     [[TYVoipDarwinManager sharedVoip] stopCall];

//清空現有的鏈接節點(再也不接收節點的數據)

     [[TYVoipDarwinManager sharedVoip] clearClientNodeList];

     //中止視圖渲染

     [self.preView stopRendering];

     [self.otherView stopRendering];

 }

 <4>代碼中出現代理方法詳解

- (void)localVideoImage:(TYVoipVideoData *)image{//甲畫面處理

     if ([self.preView isRenderring]){

         [self.preView renderVoipVideoData:image];//進行甲畫面渲染

     }

}

- (void)remoteVideoImage:(TYVoipVideoData *)image{//乙畫面處理

     if ([self.otherView isRenderring]){

         [self.otherView renderVoipVideoData:image]; //乙畫面渲染

     }

}

- (void)previewAudio:(NSData *)data{//本地語音

}

- (void)mixedAudio:(NSData *)data{//其餘節點語音,混音

}

項目中最重要的代碼介紹完啦，那測試一下，看看咱們的成果吧。

 

 

圖8  測試效果圖

 

到這裏，搭建一套完整的iOS音視頻通訊系統就完成了，圖鴨君在demo裏實現了兩路通訊。多路通訊的原理與兩路如出一轍，小夥伴們思考一下，動手搭建多路通訊吧~