描述

用戶可以將正在進(jìn)行的視頻通話保持，待需要的時候再恢復(fù)通話，能減少撥號次數(shù)，使用更方便。

視頻通話已建立，主被叫正在通話中。

業(yè)務(wù)流程

圖1 保持和恢復(fù)視頻通話流程
點(diǎn)擊放大

保持通話

說明：

通話中，主被叫雙方均可以發(fā)起保持通話操作。

視頻通話保持，需先移除視頻，再保持音頻通話；恢復(fù)通話，需先恢復(fù)音頻通話，再打開視頻。

請求發(fā)起方UI調(diào)用tsdk_del_video()發(fā)起視頻轉(zhuǎn)音頻呼叫請求，移除本地和遠(yuǎn)端視頻窗口，UI界面顯示為音頻通話界面。
說明：

當(dāng)前服務(wù)器暫不支持視頻通話保持，需要先移除視頻窗口，轉(zhuǎn)換為語音通話后再保持通話。
被請求方收到TSDK_E_CALL_EVT_CLOSE_VIDEO_IND關(guān)閉視頻通知，移除本地和遠(yuǎn)端視頻窗口，UI界面顯示為音頻通話界面。

請求發(fā)起方UI調(diào)用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發(fā)送保持通話請求，與業(yè)務(wù)服務(wù)器和被請求方完成通話保持交互處理，請求方SDK向UI上報保持通話成功事件TSDK_E_CALL_EVT_HOLD_SUCCESS，對應(yīng)事件數(shù)據(jù)結(jié)構(gòu)TSDK_S_CALL_INFO中，TSDK_E_CALL_STATE 標(biāo)識呼叫狀態(tài)為TSDK_E_CALL_STATE_HOLD，UI刷新界面提示當(dāng)前通話保持中，并顯示恢復(fù)通話入口；

說明：

保持通話可能由于服務(wù)器權(quán)限或當(dāng)前通話業(yè)務(wù)限制，導(dǎo)致用戶保持通話失敗，此時SDK向UI上報保持通話失敗事件TSDK_E_CALL_EVT_HOLD_FAILED，TSDK_S_CALL_INFO中，TSDK_E_CALL_STATE 標(biāo)識呼叫狀態(tài)為TSDK_E_CALL_STATE_LIVE,通話中；
在業(yè)務(wù)服務(wù)器支持播放保持提示音時，被保持方可以聽到由服務(wù)器側(cè)播放的保持提示音；
為了較優(yōu)的業(yè)務(wù)體驗，建議在通話保持時，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;
}

												 

恢復(fù)通話

說明：

保持通話發(fā)起方才可進(jìn)行恢復(fù)通話操作。

請求發(fā)起方UI調(diào)用tsdk_unhold_call()接口恢復(fù)處于保持態(tài)的通話。

代碼示例：

//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發(fā)送恢復(fù)通話請求，與業(yè)務(wù)服務(wù)器和被請求方完成通話恢復(fù)交互處理，請求方SDK向UI上報恢復(fù)通話成功事件TSDK_E_CALL_EVT_UNHOLD_SUCCESS，對應(yīng)事件數(shù)據(jù)結(jié)構(gòu)對應(yīng)事件數(shù)據(jù)結(jié)構(gòu)TSDK_S_CALL_INFO中，TSDK_E_CALL_STATE 標(biāo)識呼叫狀態(tài)為TSDK_E_CALL_STATE_LIVE，UI刷新界面顯示通話中。

說明：

恢復(fù)通話可能由于網(wǎng)絡(luò)側(cè)極低概率的沖突或異常，導(dǎo)致用戶恢復(fù)通話失敗，此時SDK向UI上報恢復(fù)通話失敗事件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;
}

												 

請求發(fā)起方UI調(diào)用tsdk_add_video()發(fā)起音頻轉(zhuǎn)視頻呼叫請求。

代碼示例：

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

												 

請求發(fā)起方UI先完成本地窗口和遠(yuǎn)端窗口創(chuàng)建，再調(diào)用tsdk_set_video_window()接口設(shè)置視頻窗口與呼叫的綁定關(guān)系。

代碼示例：

//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應(yīng)刷新界面通知用戶遠(yuǎn)端請求轉(zhuǎn)視頻。

代碼示例：

//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調(diào)用tsdk_reply_add_video()接口來處理轉(zhuǎn)視頻請求，參數(shù)為呼叫標(biāo)識call_id和is_accept標(biāo)識。接收轉(zhuǎn)視頻請求時，is_accept標(biāo)識的值為TSDK_TRUE；拒絕轉(zhuǎn)視頻請求時，is_accept標(biāo)識的值為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;

												 

被請求發(fā)起方UI先完成本地窗口和遠(yuǎn)端窗口創(chuàng)建，再調(diào)用tsdk_set_video_window()接口設(shè)置視頻窗口與呼叫的綁定關(guān)系，UI顯示遠(yuǎn)端和近端視頻窗口。

代碼示例：

//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根據(jù)事件顯示遠(yuǎn)端和近端視頻窗口。

代碼示例：

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

												 

注意事項

因通話雙方均可以在本端處于通話態(tài)發(fā)起保持操作，即通話可能會處于雙向保持態(tài)，在任一保持方發(fā)起恢復(fù)通話時，僅能恢復(fù)本端通話狀態(tài)，不會恢復(fù)對端的通話狀態(tài)；視頻通話雙向保持中任一方先恢復(fù)通話，不會自動打開視頻。

黄h片网址在线观看,五月婷婷网址,一级一级一级毛片免费毛片,欧美一级视频免费观看

入門使用

保持和恢復(fù)視頻通話

描述

業(yè)務(wù)流程

注意事項