描述

用户点对点视频通话。

主被叫客户端均已注册。

业务流程

图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. 主叫发起视频呼叫后，就调用tsdk_set_video_window()接口设置视频窗口与呼叫的绑定关系。
   代码示例：

   - (BOOL)updateVideoWindowWithLocal:(id)localVideoView andRemote:(id)remoteVideoView andBFCP:(id)bfcpVideoView callId:(unsigned int)callId
   {    
       TSDK_S_VIDEO_WND_INFO videoInfo[3];    
       memset_s(videoInfo, sizeof(TSDK_S_VIDEO_WND_INFO) * 2, 0, sizeof(TSDK_S_VIDEO_WND_INFO) * 2);    
       videoInfo[0].video_wnd_type = TSDK_E_VIDEO_WND_LOCAL;    
       videoInfo[0].render = (TSDK_UPTR)localVideoView;    
       videoInfo[0].display_mode = TSDK_E_VIDEO_WND_DISPLAY_FULL;    
       videoInfo[1].video_wnd_type = TSDK_E_VIDEO_WND_REMOTE;    
       videoInfo[1].render = (TSDK_UPTR)remoteVideoView;   
       videoInfo[1].display_mode = TSDK_E_VIDEO_WND_DISPLAY_CUT;    
       videoInfo[2].video_wnd_type = TSDK_E_VIDEO_WND_AUX_DATA;    
       videoInfo[2].render = (TSDK_UPTR)bfcpVideoView;    
       TSDK_RESULT ret;    
       videoInfo[2].display_mode = TSDK_E_VIDEO_WND_DISPLAY_CUT;    
       ret = tsdk_set_video_window((TSDK_UINT32)callId, 3, videoInfo);    
       DDLogInfo(@"Call_Log: tsdk_set_video_window = %d",ret);        
       [self updateVideoRenderInfoWithVideoIndex:CameraIndexFront withRenderType:TSDK_E_VIDEO_WND_LOCAL andCallId:callId];    
       [self updateVideoRenderInfoWithVideoIndex:CameraIndexFront withRenderType:TSDK_E_VIDEO_WND_REMOTE andCallId:callId];    return (TSDK_SUCCESS == ret);
   }

    
3. 主叫SDK发出呼叫请求消息，向UI上报发起呼叫结果事件TSDK_E_CALL_EVT_CALL_START_RESULT。
4. 主叫SDK发出呼叫请求消息，向UI上报呼出事件TSDK_E_CALL_EVT_CALL_OUTGOING；被叫SDK收到呼叫请求消息，向UI上报来电事件TSDK_E_CALL_EVT_CALL_INCOMING，通知事件携带参数call_id标识本次呼叫，对应的事件数据结构中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];
   }

    
5. 主叫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;        
   }

    
6. 被叫调用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;
   }

    
7. 被叫用户若视频接听，UI先完成本地窗口和远端窗口创建，再调用tsdk_set_video_window()接口设置视频窗口与呼叫的绑定关系。
   说明： 

   被叫用户若选择音频接听，则被叫用户无需此步骤。

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

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

9. 主被叫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];
   }

    

注意事项

无。