主頁(yè) > 服務(wù)與支持 > 開(kāi)發(fā)平臺(tái) > 客戶(hù)端SDK參考 > Windows Native SDK > 音視頻呼叫 保持和恢復(fù)視頻通話(huà)
更新時(shí)間:2019-11-20
用戶(hù)可以將正在進(jìn)行的視頻通話(huà)保持,待需要的時(shí)候再恢復(fù)通話(huà),能減少撥號(hào)次數(shù),使用更方便。
視頻通話(huà)已建立,主被叫正在通話(huà)中。
保持通話(huà)
通話(huà)中,主被叫雙方均可以發(fā)起保持通話(huà)操作。
視頻通話(huà)保持,需先移除視頻,再保持音頻通話(huà);恢復(fù)通話(huà),需先恢復(fù)音頻通話(huà),再打開(kāi)視頻。
當(dāng)前服務(wù)器暫不支持視頻通話(huà)保持,需要先移除視頻窗口,轉(zhuǎn)換為語(yǔ)音通話(huà)后再保持通話(huà)。
//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; |
//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; } |
恢復(fù)通話(huà)
保持通話(huà)發(fā)起方才可進(jìn)行恢復(fù)通話(huà)操作。
//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; |
恢復(fù)通話(huà)可能由于網(wǎng)絡(luò)側(cè)極低概率的沖突或異常,導(dǎo)致用戶(hù)恢復(fù)通話(huà)失敗,此時(shí)SDK向UI上報(bào)恢復(fù)通話(huà)失敗事件TSDK_E_CALL_EVT_UNHOLD_FAILED,并自動(dòng)掛斷通話(huà)。
//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; } |
//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; |
//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; |
//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; |
//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; |
//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; |
//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; |
因通話(huà)雙方均可以在本端處于通話(huà)態(tài)發(fā)起保持操作,即通話(huà)可能會(huì)處于雙向保持態(tài),在任一保持方發(fā)起恢復(fù)通話(huà)時(shí),僅能恢復(fù)本端通話(huà)狀態(tài),不會(huì)恢復(fù)對(duì)端的通話(huà)狀態(tài);視頻通話(huà)雙向保持中任一方先恢復(fù)通話(huà),不會(huì)自動(dòng)打開(kāi)視頻。