描述

用户在通话接通前可进行取消呼叫或拒绝呼叫等操作，通话过程中可以结束通话。

业务流程

图1 结束通话(呼叫)流程 

主叫或被叫在通话过程中挂断呼叫

说明： 

通话双方均可挂断呼叫，本章节以主叫发起挂断为例。

1. 主叫UI调用tsdk_end_call()接口挂断通话。
   代码示例：

   -(BOOL)endCall:(unsigned int)callId
   {    
       TSDK_UINT32 callid = (TSDK_UINT32)callId;    
       TSDK_RESULT ret = tsdk_end_call(callid);        
       return ret == TSDK_SUCCESS ? YES : NO;
   }

    
2. 主、被叫SDK完成呼叫挂断信令交互，向UI上报通话结束事件TSDK_E_CALL_EVT_CALL_ENDED，UI刷新界面显示通话结束。
   代码示例：

   case TSDK_E_CALL_EVT_CALL_ENDED:        
   {            
       DDLogInfo(@"Call_Log: recv call notify :CALL_E_EVT_CALL_ENDED");            
       TSDK_S_CALL_INFO *callInfo = (TSDK_S_CALL_INFO *)notify.data;            
       CallInfo *tsdkCallInfo = [CallInfo transfromFromCallInfoStract:callInfo];            
       NSDictionary *resultInfo = @{                                         
           TSDK_CALL_INFO_KEY : tsdkCallInfo                                         
       };            
       [self respondsCallDelegateWithType:CALL_CLOSE result:resultInfo];
   }

    

主叫在通话接通前取消呼叫

1. 主叫UI调用tsdk_end_call()接口取消呼叫。
   代码示例：

   -(BOOL)endCall:(unsigned int)callId
   {    
       TSDK_UINT32 callid = (TSDK_UINT32)callId;    
       TSDK_RESULT ret = tsdk_end_call(callid);        
       return ret == TSDK_SUCCESS ? YES : NO;
   }

    
2. 主、被叫SDK完成呼叫挂断信令交互，向UI上报通话结束事件TSDK_E_CALL_EVT_CALL_ENDED，UI刷新界面显示通话结束。
   代码示例：

   case TSDK_E_CALL_EVT_CALL_ENDED:        
   {            
       DDLogInfo(@"Call_Log: recv call notify :CALL_E_EVT_CALL_ENDED");            
       TSDK_S_CALL_INFO *callInfo = (TSDK_S_CALL_INFO *)notify.data;            
       CallInfo *tsdkCallInfo = [CallInfo transfromFromCallInfoStract:callInfo];            
       NSDictionary *resultInfo = @{                                         
           TSDK_CALL_INFO_KEY : tsdkCallInfo                                         
       };            
       [self respondsCallDelegateWithType:CALL_CLOSE result:resultInfo];
   }

    

被叫在收到来电时拒绝呼叫

1. 被叫UI调用tsdk_end_call()接口拒绝通话。
   代码示例：

   -(BOOL)endCall:(unsigned int)callId
   {    
       TSDK_UINT32 callid = (TSDK_UINT32)callId;    
       TSDK_RESULT ret = tsdk_end_call(callid);        
       return ret == TSDK_SUCCESS ? YES : NO;
   }

    
2. 主、被叫SDK完成呼叫挂断信令交互，向UI上报通话结束事件TSDK_E_CALL_EVT_CALL_ENDED，UI刷新界面显示通话结束。
   说明： 

   在实际现网部署过程中，业务服务器可能开启了呼叫等待功能，在被叫拒绝呼叫时，业务服务器会与主叫建立通话并播放提示音“对方忙”或“对方通话中”，主叫SDK在此过程中会上报TSDK_E_CALL_EVT_CALL_CONNECTED事件，需要用户通过主叫UI主动挂断呼叫。

   代码示例：

   case TSDK_E_CALL_EVT_CALL_ENDED:        
   {            
       DDLogInfo(@"Call_Log: recv call notify :CALL_E_EVT_CALL_ENDED");            
       TSDK_S_CALL_INFO *callInfo = (TSDK_S_CALL_INFO *)notify.data;            
       CallInfo *tsdkCallInfo = [CallInfo transfromFromCallInfoStract:callInfo];            
       NSDictionary *resultInfo = @{                                         
           TSDK_CALL_INFO_KEY : tsdkCallInfo                                         
       };            
       [self respondsCallDelegateWithType:CALL_CLOSE result:resultInfo];
   }

    

被叫在收到来电时未接听

1. 主、被叫SDK向UI上报通话结束事件TSDK_E_CALL_EVT_CALL_ENDED，UI刷新界面显示通话结束。
   说明： 

   在实际现网部署过程中，业务服务器可能开启了呼叫等待功能，在被叫拒绝呼叫时，业务服务器会与主叫建立通话并播放提示音“对方未接听”，主叫SDK在此过程中会上报TSDK_E_CALL_EVT_CALL_RTP_CREATED或TSDK_E_CALL_EVT_CALL_CONNECTED事件，需要用户通过主叫UI主动挂断呼叫。

   代码示例：

   case TSDK_E_CALL_EVT_CALL_ENDED:        
   {            
       DDLogInfo(@"Call_Log: recv call notify :CALL_E_EVT_CALL_ENDED");            
       TSDK_S_CALL_INFO *callInfo = (TSDK_S_CALL_INFO *)notify.data;            
       CallInfo *tsdkCallInfo = [CallInfo transfromFromCallInfoStract:callInfo];            
       NSDictionary *resultInfo = @{                                         
           TSDK_CALL_INFO_KEY : tsdkCallInfo                                         
       };            
       [self respondsCallDelegateWithType:CALL_CLOSE result:resultInfo];
   }

    

注意事项

无。