互联网点对点音视频

1、点对点音视频开发说明             

1.1、实时音频、实时视频均通过相同的接口进行调用,遵循相同的业务流程。不同的业务通过呼叫接口参数CallType进行区分,VIDEO视频、VOICE音频等。               
1.2、接口逻辑               
接口调用是采取异步调用的方式。所有的呼叫相关接口的调用结果通过回调接口ECVoIPCallDelegate中的方法OnCallEvents来接受服务端返回的各种状态。             
1.3、业务流程
  • 客户A呼叫客户B发起请求             
  • 云通讯服务端收到A请求并把请求转发给B               
  • 客户B收到请求并应答                
  • 云通讯服务端收到B应答并转发A            
  • A收到应答,通话建立                    

2、代码示例                               

音频呼叫 

我们假设Tony音频呼叫John,则代码如下:                                        
  • self.callID = [[ECDevice sharedInstance].VoIPManager makeCallWithType:VOICE andCalled:@ "John的登录账号"];
  • if (self.callid.length <= 0)//获取CallID失败,即拨打失败
  • {
  • }
  • 说明:self.callID如果返回空则代表呼叫失败,可能是参数错误引起。否则返回是一串数字,是当前通话的标识。                                                              

视频呼叫 

我们假设Tony视频呼叫John,此时代码和音频呼叫相同,区别是呼叫类型需要传VIDEO,并且在呼叫前需要设置本地和对方的视频view,代码如下:                                    
  • [[ECDevice sharedInstance].VoIPManager setVideoView:remoteVideoView andLocalView:localVideoView];
  • self.callID = [[ECDevice sharedInstance].VoIPManager
  • makeCallWithType:VIDEO andCalled: @ "John的登录号码"];
  • if (self.callid.length <= 0)//获取CallID失败,即拨打失败
  • {
  • }
  • 说明:self.callID如果返回空则代表呼叫失败,可能是参数错误引起。否则返回是一串数字,是当前通话的标识。视频时(包含点对点和会议),设置远端UIView的属性contentMode:(setVideoView:remoteVideoView)UIViewContentModeScaleToFill 
  •  //view默认值,图像数据显示,填充view,但不等比例拉伸UIViewContentModeScaleAspectFit 
  •  //图像等比例拉伸,完全显示内容UIViewContentModeScaleAspectFill 
  •  //图像等比例拉伸,填充view,部分内容可能不显示                                               

离线呼叫 

我们假设Tony不在线,John呼叫Tony的音视频,需要在拿到远程推送的时候解析出callid并实现onGetOfflineCallId,代码如下:                                        
  • - (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler{
  •     NSError *parseError = nil;
  •     NSData  *jsonData = [NSJSONSerialization dataWithJSONObject:userInfo
  •                                                     options:NSJSONWritingPrettyPrinted error:&parseError];
  •     NSString *str =  [[NSString alloc] initWithData:jsonData encoding:NSUTF8StringEncoding];

  •     UIAlertView *alert = [[UIAlertView alloc] initWithTitle:@"推送内容"
  •                                                     message:str
  •                                                    delegate:nil
  •                                           cancelButtonTitle:NSLocalizedString(@"OK", @"OK")
  •                                           otherButtonTitles:nil];
  •     [alert show];    
  •     NSLog(@"远程推送str:%@",str);
  •     NSLog(@"远程推送1:%@",userInfo);
  •     NSLog(@"远程推送r:%@",[userInfo objectForKey:@"r"]);
  •     NSLog(@"远程推送s:%@",[userInfo objectForKey:@"s"]);
  •     
  •     self.callid = nil;
  •     NSString *userdata = [userInfo objectForKey:@"c"];
  •     NSLog(@"远程推送userdata:%@",userdata);
  •     if (userdata) {
  •         NSDictionary*callidobj = [NSJSONSerialization JSONObjectWithData:[userdata dataUsingEncoding:NSUTF8StringEncoding] options:NSJSONReadingMutableLeaves error:nil];
  •         NSLog(@"远程推送callidobj:%@",callidobj);
  •         if ([callidobj isKindOfClass:[NSDictionary class]]) {
  •             self.callid = [callidobj objectForKey:@"callid"];
  •         }
  •     }
  •     
  •     NSLog(@"远程推送 callid=%@",self.callid);}
  •     
  • 然后需要实现
  • /*
  • @brief 需要获取的离线呼叫CallId (用于苹果推送下来的离线呼叫callid)
  • */
  • - (NSString*)onGetOfflineCallId {
  •     NSLog(@"推送 onGetOfflineCallId=%@", [AppDelegate shareInstance].callid);
  •     return [AppDelegate shareInstance].callid;
  • }                                                       

有呼入时,用户需要处理的事件  

被叫John接到Tony的呼叫,则SDK底层调用onIncomingCallReceived方法,开发者可在此处理呼入的业务逻辑。
                
注意:在集成音视频通话的时候,当结束当前通话的时候,需要在处理回调事件的onCallEvents中调用一下releaseCall方法,以保证当前通话占用的资源都释放了,避免在下次呼叫的时候出现线路被占用现象。(android、ios均需这样操作),Ios的调用地方,onCallEvents中的ECallEnd,代码如下:               
                        
  • //有呼叫,调起对应的界面
  • - (NSString*)onIncomingCallReceived:(NSString*)callid withCallerAccount:(NSString *)caller withCallerPhone:(NSString *)callerphone withCallerName:(NSString *)callername withCallType:(CallType)calltype;{
  • //注意:如果Tony呼叫的是John的电话,则John的程序不会收到通知回调,而是直接
  • //进入PSTN网络,和正常打电话一样
  •     if(CallType == VOICE)
  •     {
  •         NSlog(@“网络音频呼叫,调起音频呼叫的界面”);
  •     }
  •     else if(CallType == VIDEO)
  •     {
  •         NSLog (@“网络音频呼叫,调起视频呼叫的界面”);
  •     } 
  • }

  • // 主叫端呼叫的时候,会有多种状态
  • //呼叫事件的回调
  • //(1)需要注册一个通知,告知外部呼叫的状态
  • -(void)onCallEvents:(VoIPCall*)voipCall {
  •     [[NSNotificationCenter defaultCenter] postNotificationName:KNOTIFICATION_onCallEvent object:voipCall];
  • }
  • //(2)外部成为观察者,并在通知里面监听呼叫的状态
  • [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(onCallEvents:) name:KNOTIFICATION_onCallEvent object:nil];

  • //监听呼叫的状态
  • -(void)onCallEvents:(NSNotification *)notification {VoIPCall* voipCall = notification.object;
  •     if (![self.callID isEqualToString:voipCall.callID])
  •     {
  •         return;
  •     }
  •     
  •     // 呼叫的状态
  •     ECallProceeding = 0,    //外呼,服务器回100Tring
  •     ECallAlerting,          //外呼对方振铃
  •     ECallFailed,            //外呼失败
  •     ECallRing,              //呼叫振铃
  •     ECallStreaming,         //通话,外呼和来电
  •     ECallReleasing,         //释放呼叫请求中
  •     ECallPaused,            //呼叫保持
  •     ECallPausedByRemote,    //呼叫被保持
  •     ECallResumed,           //呼叫恢复
  •     ECallResumedByRemote,   //呼叫被恢复
  •     ECallTransfered,        //呼叫被转移
  •     ECallEnd                //呼叫释放
  •     switch (voipCall.callStatus) {case ECallProceeding:
  •         {
  •         }
  •             break; 
  •         case ECallStreaming:
  •         {
  •         }
  •             break;            
  •         case ECallAlerting:
  •         {                    
  •         }
  •             break;            
  •         case ECallEnd:
  •         {            
  •         }
  •             break;            
  •         case ECallRing:
  •         {
  •         }
  •             break;
  •             
  •         case ECallPaused:
  •         {           
  •         }
  •             break;
  •             
  •         case ECallPausedByRemote:
  •         {          
  •         }
  •             break;
  •             
  •         case ECallResumed:
  •         {           
  •         }
  •             break;            
  •         case ECallResumedByRemote:
  •         {          
  •         }
  •             break;            
  •         case ECallTransfered:
  •         {         
  •         }
  •             break;            
  •         case ECallFailed:
  •         {NSlog(@"Tony收到呼叫John失败的回调");
  •             if( voipCall.reason == ECErrorType_NoResponse){
  •     NSLog(@"网络不给力"); 
  •             }
  •             else if( voipCall.reason == ECErrorType_BadCredentials )
  •             {
  •                 NSLog(@"鉴权失败");
  •             }
  •             else if ( voipCall.reason == ECErrorType_CallBusy || voipCall.reason == ECErrorType_Declined )
  •             {
  •                 NSLog(@"您拨叫的用户正忙,请稍后再拨");
  •             }
  •             else if( voipCall.reason == ECErrorType_NoResponse)
  •             {
  •                 NSLog(@"对方不在线");
  •             }
  •             else if( voipCall.reason == ECErrorType_CallMissed )
  •             {
  •                 NSLog(@"呼叫超时");
  •             }
  •             else if( voipCall.reason == ECErrorType_NoNetwork )
  •             {
  •                 NSLog(@"当前无网络");
  •             }
  •             else if( voipCall.reason == ECErrorType_SDKUnSupport)
  •             {
  •                 NSLog(@"该版本不支持此功能");
  •             }
  •             else if( voipCall.reason == ECErrorType_CalleeSDKUnSupport )
  •             {
  •                 NSLog(@"对方版本不支持音频");
  •             }
  •             else
  •             {
  •                 NSLog(@"呼叫失败");}
  •         }
  •             break;
  •        case ECallEnd:
  •         { 
  •           //无论是Tony还是John主动结束通话,双方都会进入到此回调
  •             NSLog(@"挂机");
  •            }
  •             break;

  •         default:
  •             break;
  •     }}                                       
                    
2.2、被叫端界面的处理
                    
假设John侧调起来音频或者视频呼入的界面,界面上有“接受”和“拒绝”两个按钮:                               
  • (1)John点击“接受”按钮,则调用的代码是
  •     //如果视频呼叫,则在接受呼叫之前,需要先设置视频通话显示的view
  •     [[ECDevice sharedInstance].VoIPManager setVideoView:remoteVideoView andLocalView:localVideoView];    
  •     NSInteger ret = [[ECDevice ShareIntance].VoIPManager
  •     acceptCall:self.callID withType: VOICE(视频: VIDEO)];
  •     if (ret == 0)// 音频或视频通话界面
  •     {
  •         NSLog (@“被叫端接受呼叫成功”);
  •     }
  •     else
  •    {
  •          NSlog(@“被叫端接受呼叫失败”);
  •     }(2)John点击“拒绝”按钮,音视频拒绝的代码是一致的,调用的代码是:
  •     NSInteger ret = [[ECDevice ShareIntance].VoIPManager 
  •     rejectCall:self.callID andReason: ECErrorType_CallBusy];
  •     if (ret == 0)
  •     {
  •         NSLog (@“被叫端拒绝呼叫成功”);
  •     }
  •     else
  •     {
  •         NSLog (@“被叫端拒绝呼叫失败”);
  •     }
  •     
  •                         
                
                                                   

结束通话 

Tony和John的通话过程中,任何一方想结束呼叫,则都可以调用如下代码:                    
                  
  • [[ECDevice ShareIntance].VoIPManager releaseCall:mCurrentID];                                               

3、辅助接口

                    

获取通话ID                                        

  • [[ECDevice sharedInstance].VoIPManager getCurrentCall;
  • 功能:获取当前通话的callid,
  • 参数:无
  • 返回值:当前通话id               
                    

发送DTMF                                      

  • [[ECDevice sharedInstance].VoIPManager sendDTMF:(NSString *)callid dtmf:(NSString *)dtmf;
  • 功能:获取当前通话的callid,
  • 参数:callid-通话id
  •       dtmf-键值-        
  • 返回值:当前通话id                                 
                                     

设置扬声器状态                                       

  • [ECDevice sharedInstance] .VoIPManager enableLoudsSpeaker:(BOOL)enable;
  • 功能:免提设置
  • 参数:enable - NO:关闭 YES:打开
  • 返回值:无                                   
                                     

获取扬声器状态                                     

  • [ECDevice sharedInstance] .VoIPManager getLoudsSpeakerStatus;
  • 功能:获取当前免提状态
  • 参数:enable - NO:关闭 YES:打开
  • 返回值:无                                   

设置静音

  • [ECDevice sharedInstance].VoIPManager setMute:(BOOL)on
  • 功能:静音设置
  • 参数:enable - NO:正常 YES:静音
  • 返回值:无

获取静音的状态         

                               
  • [ECDevice sharedInstance] .VoIPManager getMuteStatus
  • 功能:获取当前静音状态
  • 参数:enable - NO:正常 YES:静音
  • 返回值:无                                 
                    
接近检测,通话时如果贴近听筒,关闭屏幕(暂缓提供)                                        
  • [ECDevice sharedInstance].VoIPManager enterVoipCallFlow:(BOOL)status
  • 功能:是否抑制马赛克
  • 参数:NO:关闭 YES:打开
  • 返回值:无
            

设置视频通话显示的窗口                    

  • [ECDevice sharedInstance] .VoIPManager setVideoView:(UIView*)viewandLocalView:(UIView*)localView
  • 功能:视频通话显示的view
  • 参数:view-对方显示视图和本地显示视图
  • 返回值:无
                                                     

获取手机摄像头参数

  • [ECDevice sharedInstance].VoIPManager getCameraInfo
  • 功能:获取摄像设备信息
  • 参数:无
  • 返回值: 摄像设备信息数组

切换前置和后置摄像头                                       

  •   [[ECDevice sharedInstance].VoIPManager
  •   selectCamera:(NSInteger)cameraIndex capability:(NSInteger)capabilityIndex fps:(NSInteger)fps 
  •   rotate:(ECRotate)rotate force:(BOOL)isForce scale:(CGFloat)scale]
  •   功能:选择使用的摄像设备参数:cameraIndex-设备index
  •       capabilityIndex-能力index
  •       fps-帧率
  •       rotate-旋转的角度
  •       isForce 是否强制启动本SDK调用的摄像头,默认使用NO
  •       scale 编码缩放,正实数。默认1.0,小于1.0缩小,大于1.0放大返回值: 摄像设备信息数组                   
                                  

设置编码范式                                        

  • [ECDevice sharedInstance].VoIPManager  
  • setCodecEnabledWithCodec:(ECCodec) codec andEnabled:(BOOL) enabled
  • 功能:设置支持的编解码方式
  • 参数:codec-编解码类型
  •       enabled- NO:不支持 YES:支持返回值: 无                                                         

获取编解码方式是否支持                                        

  • [ECDevice sharedInstance].VoIPManager  
  • getCondecEnabelWithCodec:(ECCodec) codec
  • 功能:获取编解码方式是否支持
  • 参数:codec-编解码类型
  • 返回值: NO:不支持 YES:支持       

设置音频处理的类型和对用的处理模式                                 

  • [ECDevice sharedInstance].VoIPManager  
  • setAudioConfigEnabledWithType:(ECAudioType) type andEnabled:(BOOL) enabled andMode:(NSInteger) mode
  • 功能:设置音频处理的开关
  • 参数:type-音频处理类型
  •       enabled-YES:开启,NO:关闭
  •       mode-各自对应的模式: AUDIO_AgcMode、AUDIO_EcMode、AUDIO_NsMode.
  • 返回值: 成功 0 失败 -1                     
                                        

获取音频处理的开关                                        

  • [ECDevice sharedInstance].VoIPManager  
  • getAudioConfigEnabelWithType:(ECAudioType) type
  • 功能:获取音频处理的开关
  • 参数:type-音频处理类型
  •      enabled-YES:开启,NO:关闭
  • 返回值: 成功:音频属性结构 失败:nil
                                                                      

统计通话质量                                    

  • [ECDevice sharedInstance].VoIPManager 
  • getCallStatisticsWithCallid:(NSString*) digid andType:(CallType)type
  • 功能:统计通话质量返回值: 返回丢包率等通话质量信息对象                   
                

获取通话的网络流量信息                                        

  • [ECDevice sharedInstance].VoIPManager  
  • getNetworkStatisticWithCallId:(NSString*) callid
  • 功能:获取通话的网络流量信息
  • 参数:callid :会话ID,会议类传入房间号
  • 返回值:网络流量信息对象
                                

设置视频通话码率                                       

  • [ECDevice sharedInstance].VoIPManager  
  • setVideoBitRates:(NSInteger)bitrates
  • 功能:设置视频通话码率
  • 参数:bitrates  视频码流,kb/s,范围30-300
  • 返回值:无                 

获取服务器callSid

  建议通话建立后获取。                                     
  • [[ECDevice sharedInstance].VoIPManager 
  • getServerIdFromCallId:callid
  • 参数:callid-通话id
  • 返回值:callSid