智慧服务，成就美好体验 项目咨询

主页 > 服务与支持 > 开发平台 > 客户端SDK参考 > iOS Native SDK > 音视频呼叫 保持和恢复视频通话

入门使用

保持和恢复视频通话

更新时间：2019-11-20

描述

用户可以将正在进行的视频通话保持，待需要的时候再恢复通话，能减少拨号次数，使用更方便。

视频通话已建立，主被叫正在通话中。

业务流程

图1 保持和恢复视频通话流程 

保持通话

说明： 

通话中，主被叫双方均可以发起保持通话操作。

视频通话保持，需先移除视频，再保持音频通话；恢复通话，需先恢复音频通话，再打开视频。

  1. 请求发起方UI调用tsdk_del_video()发起视频转音频呼叫请求，移除本地和远端视频窗口，UI界面显示为音频通话界面。
    说明： 

    当前服务器暂不支持视频通话保持，需要先移除视频窗口，转换为语音通话后再保持通话。

  2. 被请求方收到TSDK_E_CALL_EVT_CLOSE_VIDEO_IND关闭视频通知，移除本地和远端视频窗口，UI界面显示为音频通话界面。
  3. 请求发起方UI调用tsdk_hold_call()接口保持通话。
    代码示例： 
    -(BOOL)holdCallWithCallId:(unsigned int)callId
{    
    TSDK_RESULT ret = tsdk_hold_call(callId);    
    DDLogInfo(@"Call_Log: tsdk_hold_call = %@",(TSDK_SUCCESS == ret)?@"YES":@"NO");    
    return ret == TSDK_SUCCESS ? YES : NO;
}
     
  4. 请求方SDK发送保持通话请求，与业务服务器和被请求方完成通话保持交互处理，请求方SDK向UI上报保持通话成功事件TSDK_E_CALL_EVT_HOLD_SUCCESS，对应事件数据结构TSDK_S_CALL_INFO中，TSDK_E_CALL_STATE 标识呼叫状态为TSDK_E_CALL_STATE_HOLD，UI刷新界面提示当前通话保持中，并显示恢复通话入口；
    说明： 
    1. 保持通话可能由于服务器权限或当前通话业务限制，导致用户保持通话失败，此时SDK向UI上报保持通话失败事件TSDK_E_CALL_EVT_HOLD_FAILED，TSDK_S_CALL_INFO中，TSDK_E_CALL_STATE 标识呼叫状态为TSDK_E_CALL_STATE_LIVE,通话中；
    2. 在业务服务器支持播放保持提示音时，被保持方可以听到由服务器侧播放的保持提示音；
    3. 为了较优的业务体验，建议在通话保持时，UI屏蔽挂断通话入口。
    代码示例： 
    case TSDK_E_CALL_EVT_HOLD_SUCCESS:        
{            
    DDLogInfo(@"TSDK_E_CALL_EVT_HOLD_SUCCESS");            
    NSDictionary *resultInfo = @{                                         
        TSDK_CALL_HOLD_RESULT_KEY:[NSNumber numberWithBool:YES],                                         
        CALL_ID : callId                                         
    };            
    [self respondsCallDelegateWithType:CALL_HOLD_RESULT result:resultInfo];            
    break;        
}
     

 

恢复通话

说明： 

保持通话发起方才可进行恢复通话操作。

  1. 请求发起方UI调用tsdk_unhold_call()接口恢复处于保持态的通话。
    代码示例： 
    -(BOOL)unHoldCallWithCallId:(unsigned int)callId
{    
    TSDK_RESULT ret = tsdk_unhold_call(callId);        
    return ret == TSDK_SUCCESS ? YES : NO;
}
     
  2. 请求方SDK发送恢复通话请求，与业务服务器和被请求方完成通话恢复交互处理，请求方SDK向UI上报恢复通话成功事件TSDK_E_CALL_EVT_UNHOLD_SUCCESS，对应事件数据结构对应事件数据结构TSDK_S_CALL_INFO中，TSDK_E_CALL_STATE 标识呼叫状态为TSDK_E_CALL_STATE_LIVE，UI刷新界面显示通话中。
    说明： 

    恢复通话可能由于网络侧极低概率的冲突或异常，导致用户恢复通话失败，此时SDK向UI上报恢复通话失败事件TSDK_E_CALL_EVT_UNHOLD_FAILED，并自动挂断通话。

    代码示例： 
    case TSDK_E_CALL_EVT_UNHOLD_SUCCESS:        
{            
    DDLogInfo(@"TSDK_E_CALL_EVT_UNHOLD_SUCCESS");            
    NSDictionary *resultInfo = @{                                         
        TSDK_CALL_UNHOLD_RESULT_KEY:[NSNumber numberWithBool:YES],                                         
        CALL_ID : callId                                         
    };            
    [self respondsCallDelegateWithType:CALL_UNHOLD_RESULT result:resultInfo];            
    break;        
}
     
  3. 请求发起方UI调用tsdk_add_video()发起音频转视频呼叫请求。
    代码示例： 
    -(BOOL)upgradeAudioToVideoCallWithCallId:(unsigned int)callId
{    
    TSDK_RESULT ret = tsdk_add_video((TSDK_UINT32)callId);    
    DDLogInfo(@"Call_Log: tsdk_add_video = %d",ret);    
    return ret == TSDK_SUCCESS ? YES : NO;
}
     
  4. 请求发起方UI先完成本地窗口和远端窗口创建，再调用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);
}
     
  5. 被请求方SDK收到请求后，向UI上报对方请求增加视频事件TSDK_E_CALL_EVT_OPEN_VIDEO_REQ，UI应刷新界面通知用户远端请求转视频。
    代码示例： 
    case TSDK_E_CALL_EVT_OPEN_VIDEO_REQ:        
{            
    NSString *callId = [NSString stringWithFormat:@"%d",notify.param1];            
    NSDictionary *callUpgradePassiveInfo = [NSDictionary dictionaryWithObjectsAndKeys:callId,CALL_ID,nil];            
    [self respondsCallDelegateWithType:CALL_UPGRADE_VIDEO_PASSIVE result:callUpgradePassiveInfo];            
    DDLogInfo(@"Call_Log: call revice CALL_E_EVT_CALL_ADD_VIDEO");            
    break;        
}
     
  6. 被请求方UI调用tsdk_reply_add_video()接口来处理转视频请求，参数为呼叫标识call_id和is_accept标识。接收转视频请求时，is_accept标识的值为TSDK_TRUE；拒绝转视频请求时，is_accept标识的值为TSDK_FALSE。
    代码示例： 
     
-(BOOL)replyAddVideoCallIsAccept:(BOOL)accept callId:(unsigned int)callId
{    
    TSDK_BOOL isAccept = accept;    
    TSDK_RESULT ret = tsdk_reply_add_video((TSDK_UINT32)callId , isAccept);    
    return ret == TSDK_SUCCESS ? YES : NO;
}
     
  7. 被请求发起方UI先完成本地窗口和远端窗口创建，再调用tsdk_set_video_window()接口设置视频窗口与呼叫的绑定关系，UI显示远端和近端视频窗口。
    代码示例： 
    - (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);
}
     
  8. 若被请求方接受视频请求，请求方向UI上报打开视频通知事件TSDK_E_CALL_EVT_OPEN_VIDEO_IND，UI根据事件显示远端和近端视频窗口。
    代码示例： 
    case TSDK_E_CALL_EVT_OPEN_VIDEO_IND:        
{            
    NSString *callId = [NSString stringWithFormat:@"%d",notify.param1];            
    NSDictionary *callUpgradePassiveInfo = [NSDictionary dictionaryWithObjectsAndKeys:callId,CALL_ID,nil];            
    [self respondsCallDelegateWithType:CALL_REFUSE_OPEN_VIDEO result:callUpgradePassiveInfo];            
    DDLogInfo(@"Call_Log: call CALL_E_EVT_CALL_DEL_VIDEO");            
    break;        
}
     

注意事项

因通话双方均可以在本端处于通话态发起保持操作，即通话可能会处于双向保持态，在任一保持方发起恢复通话时，仅能恢复本端通话状态，不会恢复对端的通话状态；视频通话双向保持中任一方先恢复通话，不会自动打开视频。

父主题： 音视频呼叫