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

描述

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

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

业务流程

图1 保持和恢复视频通话流程
点击放大

保持通话

说明：

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

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

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

当前服务器暂不支持视频通话保持，需要先移除视频窗口，转换为语音通话后再保持通话。
被请求方收到TSDK_E_CALL_EVT_CLOSE_VIDEO_IND关闭视频通知，移除本地和远端视频窗口，UI界面显示为音频通话界面。

请求发起方UI调用tsdk_hold_call()接口保持通话。

代码示例：

//c code
TSDK_RESULT ret;
ret = tsdk_hold_call(callid);
if (TSDK_SUCCESS != ret)
{
    LOG_D_CALL_ERROR("hold failed. result=%#x", ret);
    return -1;
}
return TSDK_SUCCESS;

												 

请求方SDK发送保持通话请求，与业务服务器和被请求方完成通话保持交互处理，请求方SDK向UI上报保持通话成功事件TSDK_E_CALL_EVT_HOLD_SUCCESS，对应事件数据结构TSDK_S_CALL_INFO中，TSDK_E_CALL_STATE 标识呼叫状态为TSDK_E_CALL_STATE_HOLD，UI刷新界面提示当前通话保持中，并显示恢复通话入口；

说明：

保持通话可能由于服务器权限或当前通话业务限制，导致用户保持通话失败，此时SDK向UI上报保持通话失败事件TSDK_E_CALL_EVT_HOLD_FAILED，TSDK_S_CALL_INFO中，TSDK_E_CALL_STATE 标识呼叫状态为TSDK_E_CALL_STATE_LIVE,通话中；
在业务服务器支持播放保持提示音时，被保持方可以听到由服务器侧播放的保持提示音；
为了较优的业务体验，建议在通话保持时，UI屏蔽挂断通话入口。

代码示例：

//c code
case TSDK_E_CALL_EVT_HOLD_SUCCESS:
{
     CHECK_POINTER(data);
     TSDK_S_CALL_INFO* callInfo = (TSDK_S_CALL_INFO*)data;
     TSDK_S_CALL_INFO* notifyInfo = new TSDK_S_CALL_INFO;
     memset(notifyInfo, 0, sizeof(TSDK_S_CALL_INFO));
     memcpy_s(notifyInfo, sizeof(TSDK_S_CALL_INFO), callInfo, sizeof(TSDK_S_CALL_INFO));

     CDemoCallCtrlDlg* pCallDlg;
     pCallDlg = CallDlgManager::GetInstance().GetCallDlgByCallID(notifyInfo->call_id);
     CHECK_POINTER(pCallDlg);
     ::PostMessage(pCallDlg->GetSafeHwnd(), WM_CALL_HOLD_SUCESS, NULL, NULL);
     break;
}

												 

恢复通话

说明：

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

请求发起方UI调用tsdk_unhold_call()接口恢复处于保持态的通话。

代码示例：

//c code
TSDK_RESULT ret;
ret = tsdk_unhold_call(callid);
if (TSDK_SUCCESS != ret)
{
    LOG_D_CALL_ERROR("unhold failed. result=%#x", ret);
    return -1;
}
return TSDK_SUCCESS;

												 

请求方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，并自动挂断通话。

代码示例：

//c code
case TSDK_E_CALL_EVT_UNHOLD_SUCCESS:
{
     CHECK_POINTER(data);
     TSDK_S_CALL_INFO* callInfo = (TSDK_S_CALL_INFO*)data;
     TSDK_S_CALL_INFO* notifyInfo = new TSDK_S_CALL_INFO;
     memset(notifyInfo, 0, sizeof(TSDK_S_CALL_INFO));
     memcpy_s(notifyInfo, sizeof(TSDK_S_CALL_INFO), callInfo, sizeof(TSDK_S_CALL_INFO));

     CDemoCallCtrlDlg* pCallDlg;
     pCallDlg = CallDlgManager::GetInstance().GetCallDlgByCallID(notifyInfo->call_id);
     CHECK_POINTER(pCallDlg);
     ::PostMessage(pCallDlg->GetSafeHwnd(), WM_CALL_UNHOLD_SUCESS, NULL, NULL);
     break;
}

												 

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

												 

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

												 

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

												 

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

												 

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

代码示例：

//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;

												 

若被请求方接受视频请求，请求方向UI上报打开视频通知事件TSDK_E_CALL_EVT_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;

												 

注意事项

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

入门使用

保持和恢复视频通话

描述

业务流程

注意事项