音视频呼叫_湖南轩利_为用户提供一站式的云服务及音视频整体解决方案

入门使用

音频通话转视频通话

更新时间：2019-11-20

描述

音频通话中，通话的一方发起音频通话切换为视频通话。

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

业务流程

图1 音频通话转视频通话流程
点击放大

说明：

通话中，主被叫双方均可以发起音频转视频操作。

请求发起方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;
}

请求发起方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);
}

被请求方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;        
}

被请求方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;
}
```

被请求用户接受转视频请求，UI先完成本地窗口和远端窗口创建，再调用tsdk_set_video_window()接口设置视频窗口与呼叫的绑定关系方。

说明：

只有被请求方用户接受时，才需要此步骤。

若用户长时间没有响应，被请求端应用程序应该自动拒绝转视频的请求。建议时间为45s。

代码示例：

- (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);
}

主、被叫SDK完成视频转音频信令和媒体交互处理；
若被请求方接受视频请求，请求方向UI上报打开视频通知事件TSDK_E_CALL_EVT_OPEN_VIDEO_IND，UI根据事件显示远端和近端视频窗口；被请求方点击接受后，UI显示远端和近端视频窗口。

若被请求方拒绝视频请求，请求方向UI上报远端拒绝请求打开视频通知事件TSDK_E_CALL_EVT_REFUSE_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;        
}
```

注意事项

无。