描述

用户点对点音频通话。

主被叫客户端均已注册。

业务流程

图1 建立音频通话流程 

1. 主叫UI调用tsdk_start_call()接口发起音频呼叫，传入参数包含被叫号码和是否发起视频呼叫，返回参数call_id标识本次呼叫ID。
   说明： 

   呼叫ID作为一路通话的唯一标识，UI应保存并管理，以用于后继的呼叫相关操作。

   代码示例：

   TSDK_BOOL isVideo = ((TSDK_CALL_E_CALL_TYPE)callType==CALL_VIDEO)?TSDK_TRUE:TSDK_FALSE;    
   TSDK_UINT32 callid = 0;    
   TSDK_RESULT ret = tsdk_start_call(&callid,(TSDK_CHAR*)[number UTF8String], isVideo);

    
2. 主叫SDK完成状态自检，准备呼叫请求消息，向UI上报呼出事件发起呼叫结果事件TSDK_E_CALL_EVT_CALL_START_RESULT。
3. 主叫SDK发出呼叫请求消息，向UI上报呼出事件TSDK_E_CALL_EVT_CALL_OUTGOING；被叫SDK收到呼叫请求消息，向UI上报来电事件TSDK_E_CALL_EVT_CALL_INCOMING。通知事件携带参数callid标识本次呼叫，对应的事件数据结构中TSDK_S_CALL_INFO包含远端号码、呼叫类型和呼叫状态等呼叫信息。
   代码示例：

   case TSDK_E_CALL_EVT_CALL_INCOMING:        
   {                                             
       TSDK_S_CALL_INFO *callInfo = (TSDK_S_CALL_INFO *)notify.data;            
       CallInfo *tsdkCallInfo = [CallInfo transfromFromCallInfoStract:callInfo];                        
       [self resetUCVideoOrientAndIndexWithCallId:0];                        
       NSString *callId = [NSString stringWithFormat:@"%d", callInfo->call_id];            
       [_tsdkCallInfoDic setObject:tsdkCallInfo forKey:callId];            
       NSDictionary *resultInfo = @{                                         
           TSDK_CALL_INFO_KEY : tsdkCallInfo                                         
       };            
       [self respondsCallDelegateWithType:CALL_INCOMMING result:resultInfo];
   }

    
4. 主叫SDK在收到被叫振铃通知时，上报TSDK_E_CALL_EVT_CALL_RINGBACK事件，UI应播放本地回铃音。
   代码示例：

   case TSDK_E_CALL_EVT_CALL_RINGBACK:        
   {            
       NSDictionary *resultInfo = @{                                         
           TSDK_CALL_RINGBACK_KEY : [NSNumber numberWithBool:true]                                         
       };            
       [self respondsCallDelegateWithType:CALL_RINGBACK result:resultInfo];            
       break;        
   }

    
5. 被叫调用tsdk_accept_call()接听呼叫。
   说明： 

   被叫若拒绝呼叫参见结束通话（或呼叫）章节描述。

   代码示例：

   - (BOOL) answerComingCallType:(TUP_CALL_TYPE)callType callId:(unsigned int)callId
   {    
       TSDK_RESULT ret = tsdk_accept_call((TSDK_UINT32)callId, callType == CALL_AUDIO ? TSDK_FALSE : TSDK_TRUE);   
       DDLogInfo(@"Call_Log:answer call type is %d,result is %d, callid: %d",callType,ret,callId);    
       return ret == TSDK_SUCCESS ? YES : NO;
   }

    
6. 主被叫SDK向UI上报通话建立事件TSDK_E_CALL_EVT_CALL_RTP_CREATED。
   说明： 

   RTP通道已建立，可以进行一些二次拨号等操作。

7. 主被叫SDK向UI上报通话建立事件TSDK_E_CALL_EVT_CALL_CONNECTED，UI刷新界面进入通话界面，主被叫双方通话。
   代码示例：

   case TSDK_E_CALL_EVT_CALL_CONNECTED:        
   {            
       DDLogInfo(@"Call_Log: recv call notify :CALL_E_EVT_CALL_CONNECTED");            
       TSDK_S_CALL_INFO *callInfo = (TSDK_S_CALL_INFO *)notify.data;           
       CallInfo *tsdkCallInfo = [CallInfo transfromFromCallInfoStract:callInfo];            
       NSString *callId = [NSString stringWithFormat:@"%d", tsdkCallInfo.stateInfo.callId];            
       [_tsdkCallInfoDic setObject:tsdkCallInfo forKey:callId];            
       NSDictionary *resultInfo = @{                                        
           TSDK_CALL_INFO_KEY : tsdkCallInfo                                         
       };            
       [self respondsCallDelegateWithType:CALL_CONNECT result:resultInfo];
   }