主頁(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à)操作。
//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; } |
因通話(huà)雙方均可以在本端處于通話(huà)態(tài)發(fā)起保持操作,即通話(huà)可能會(huì)處于雙向保持態(tài),在任一保持方發(fā)起恢復(fù)通話(huà)時(shí),僅能恢復(fù)本端通話(huà)狀態(tài),不會(huì)恢復(fù)對(duì)端的通話(huà)狀態(tài)。