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

主页 > 服务与支持 > 开发平台 > 客户端SDK参考 > Windows Native SDK > 音视频呼叫 音频通话转视频通话

入门使用

音频通话转视频通话

更新时间：2019-11-20

描述

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

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

业务流程

图1 音频通话转视频通话流程 
说明： 

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

  1. 请求发起方UI调用tsdk_add_video()发起音频转视频呼叫请求。
    代码示例： 
    //c code 
TSDK_RESULT ret;
ret = tsdk_add_video(callid);
if (TSDK_SUCCESS != ret)
{
    LOG_D_CALL_ERROR("add video failed. result=%#x", ret);
    return -1;
}
return TSDK_SUCCESS;
     
  2. 请求发起方UI先完成本地窗口和远端窗口创建，再调用tsdk_set_video_window()接口设置视频窗口与呼叫的绑定关系。
    代码示例： 
    //c code
TSDK_RESULT ret;
TSDK_S_VIDEO_WND_INFO video_window_info[SERVICE_CALL_D_VIDEO_WINDOW_NUM] = { TSDK_E_VIDEO_WND_REMOTE };

video_window_info[TSDK_E_VIDEO_WND_LOCAL].render = (TSDK_UINT32)local_video_wnd;
video_window_info[TSDK_E_VIDEO_WND_LOCAL].video_wnd_type = TSDK_E_VIDEO_WND_LOCAL;
video_window_info[TSDK_E_VIDEO_WND_LOCAL].index = 1;
video_window_info[TSDK_E_VIDEO_WND_LOCAL].display_mode = TSDK_E_VIDEO_WND_DISPLAY_FULL;

video_window_info[TSDK_E_VIDEO_WND_REMOTE].render = (TSDK_UINT32)remote_video_wnd;
video_window_info[TSDK_E_VIDEO_WND_REMOTE].video_wnd_type = TSDK_E_VIDEO_WND_REMOTE;
video_window_info[TSDK_E_VIDEO_WND_REMOTE].index = 0;
video_window_info[TSDK_E_VIDEO_WND_REMOTE].display_mode = TSDK_E_VIDEO_WND_DISPLAY_FULL;

ret = tsdk_set_video_window(callid, SERVICE_CALL_D_VIDEO_WINDOW_NUM,video_window_info);
if(TSDK_SUCCESS != ret)
{ 
   LOG_D_CALL_ERROR("set video window info failed. result=%#x", ret);
   return -1;
}
return TSDK_SUCCESS;
     
  3. 被请求方SDK收到请求后，向UI上报对方请求增加视频事件TSDK_E_CALL_EVT_OPEN_VIDEO_REQ，UI应刷新界面通知用户远端请求转视频。
    代码示例： 
    //c code
unsigned int callID = (unsigned int)wParam;
CDemoCallCtrlDlg* pCallDlg = CallDlgManager::GetInstance().GetCallDlgByCallID(callID);
CHECK_POINTER_RETURN(pCallDlg, -1L);

CDemoPromptDlg dlg;
dlg.SetTextOfContent(L"The peer party request add video,do you agree?");
INT_PTR nResponse = dlg.DoModal();

pCallDlg->PostMessage(WM_CALL_ADD_VIDEO, (WPARAM)nResponse, NULL);
return 0L;
     
  4. 被请求方UI调用tsdk_reply_add_video()接口来处理转视频请求，参数为呼叫标识call_id和is_accept标识。接收转视频请求时，is_accept标识的值为TSDK_TRUE；拒绝转视频请求时，is_accept标识的值为TSDK_FALSE。
    代码示例： 
    //c code 
TSDK_RESULT ret;
ret = tsdk_reply_add_video(callid,isAccept);
if (TSDK_SUCCESS != ret)
{
    LOG_D_CALL_ERROR("reply add video failed. result=%#x", ret);
    return -1;
}
return TSDK_SUCCESS;
     
  5. 被请求用户接受转视频请求，UI先完成本地窗口和远端窗口创建，再调用tsdk_set_video_window()接口设置视频窗口与呼叫的绑定关系方。
    说明： 

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

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

    代码示例： 
    //c code
TSDK_RESULT ret;
TSDK_S_VIDEO_WND_INFO video_window_info[SERVICE_CALL_D_VIDEO_WINDOW_NUM] = { TSDK_E_VIDEO_WND_REMOTE };

video_window_info[TSDK_E_VIDEO_WND_LOCAL].render = (TSDK_UINT32)local_video_wnd;
video_window_info[TSDK_E_VIDEO_WND_LOCAL].video_wnd_type = TSDK_E_VIDEO_WND_LOCAL;
video_window_info[TSDK_E_VIDEO_WND_LOCAL].index = 1;
video_window_info[TSDK_E_VIDEO_WND_LOCAL].display_mode = TSDK_E_VIDEO_WND_DISPLAY_FULL;

video_window_info[TSDK_E_VIDEO_WND_REMOTE].render = (TSDK_UINT32)remote_video_wnd;
video_window_info[TSDK_E_VIDEO_WND_REMOTE].video_wnd_type = TSDK_E_VIDEO_WND_REMOTE;
video_window_info[TSDK_E_VIDEO_WND_REMOTE].index = 0;
video_window_info[TSDK_E_VIDEO_WND_REMOTE].display_mode = TSDK_E_VIDEO_WND_DISPLAY_FULL;

ret = tsdk_set_video_window(callid, SERVICE_CALL_D_VIDEO_WINDOW_NUM,video_window_info);
if(TSDK_SUCCESS != ret)
{ 
   LOG_D_CALL_ERROR("set video window info failed. result=%#x", ret);
   return -1;
}
return TSDK_SUCCESS;
     
  6. 主、被叫SDK完成视频转音频信令和媒体交互处理；

    若被请求方接受视频请求，请求方向UI上报打开视频通知事件TSDK_E_CALL_EVT_OPEN_VIDEO_IND，UI根据事件显示远端和近端视频窗口；被请求方点击接受后，UI显示远端和近端视频窗口。

    若被请求方拒绝视频请求，请求方向UI上报远端拒绝请求打开视频通知事件TSDK_E_CALL_EVT_REFUSE_OPEN_VIDEO_IND，UI销毁远端和近端视频窗口。

    代码示例： 
    //c code
/* 被请求方接受视频请求 */
unsigned int callID = (unsigned int)wParam;
CDemoCallCtrlDlg* pCallDlg;
pCallDlg = CallDlgManager::GetInstance().GetCallDlgByCallID(callID);
CHECK_POINTER_RETURN(pCallDlg, -1L);

DLG_TYPE type;
type = SIP_SIGNLE_VIDEO;
pCallDlg->SendMessage(WM_CALL_MODIFY_VIDEO, WPARAM(type), NULL);
return 0L;

/* 被请求方拒绝视频请求 */
unsigned int callID = (unsigned int)wParam;
CDemoCallCtrlDlg* pCallDlg;
pCallDlg = CallDlgManager::GetInstance().GetCallDlgByCallID(callID);
CHECK_POINTER_RETURN(pCallDlg, -1L);

DLG_TYPE type;
type = SIP_SIGNLE_CALL;
pCallDlg->SendMessage(WM_CALL_MODIFY_VIDEO, WPARAM(type), NULL);
return 0L;
     

注意事项

无。