手机看片1024精品国产,丁香婷婷成人,午夜国产一级片,黄色片网站在线免费观看,男人的天堂香蕉在线视频,一级特黄毛片在线,中文日产国产精品久久

智慧服務(wù)，成就美好體驗(yàn) 項(xiàng)目咨詢

主頁(yè) > 服務(wù)與支持 > 開發(fā)平臺(tái) > 客戶端SDK參考 > Windows Native SDK > 音視頻呼叫 保持和恢復(fù)視頻通話

入門使用

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

更新時(shí)間：2019-11-20

描述

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

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

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

圖1 保持和恢復(fù)視頻通話流程 

保持通話

說明： 

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

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

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

    當(dāng)前服務(wù)器暫不支持視頻通話保持，需要先移除視頻窗口，轉(zhuǎn)換為語音通話后再保持通話。

  2. 被請(qǐng)求方收到TSDK_E_CALL_EVT_CLOSE_VIDEO_IND關(guān)閉視頻通知，移除本地和遠(yuǎn)端視頻窗口，UI界面顯示為音頻通話界面。
  3. 請(qǐng)求發(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;
     
  4. 請(qǐng)求方SDK發(fā)送保持通話請(qǐng)求，與業(yè)務(wù)服務(wù)器和被請(qǐng)求方完成通話保持交互處理，請(qǐng)求方SDK向UI上報(bào)保持通話成功事件TSDK_E_CALL_EVT_HOLD_SUCCESS，對(duì)應(yīng)事件數(shù)據(jù)結(jié)構(gòu)TSDK_S_CALL_INFO中，TSDK_E_CALL_STATE 標(biāo)識(shí)呼叫狀態(tài)為TSDK_E_CALL_STATE_HOLD，UI刷新界面提示當(dāng)前通話保持中，并顯示恢復(fù)通話入口；
    說明： 
    1. 保持通話可能由于服務(wù)器權(quán)限或當(dāng)前通話業(yè)務(wù)限制，導(dǎo)致用戶保持通話失敗，此時(shí)SDK向UI上報(bào)保持通話失敗事件TSDK_E_CALL_EVT_HOLD_FAILED，TSDK_S_CALL_INFO中，TSDK_E_CALL_STATE 標(biāo)識(shí)呼叫狀態(tài)為TSDK_E_CALL_STATE_LIVE,通話中；
    2. 在業(yè)務(wù)服務(wù)器支持播放保持提示音時(shí)，被保持方可以聽到由服務(wù)器側(cè)播放的保持提示音；
    3. 為了較優(yōu)的業(yè)務(wù)體驗(yàn)，建議在通話保持時(shí)，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ù)通話操作。

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

    恢復(fù)通話可能由于網(wǎng)絡(luò)側(cè)極低概率的沖突或異常，導(dǎo)致用戶恢復(fù)通話失敗，此時(shí)SDK向UI上報(bào)恢復(fù)通話失敗事件TSDK_E_CALL_EVT_UNHOLD_FAILED，并自動(dòng)掛斷通話。

    代碼示例： 
    //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;
}
     
  3. 請(qǐng)求發(fā)起方UI調(diào)用tsdk_add_video()發(fā)起音頻轉(zhuǎn)視頻呼叫請(qǐng)求。
    代碼示例： 
    //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;
     
  4. 請(qǐng)求發(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;
     
  5. 被請(qǐng)求方SDK收到請(qǐng)求后，向UI上報(bào)對(duì)方請(qǐng)求增加視頻事件TSDK_E_CALL_EVT_OPEN_VIDEO_REQ，UI應(yīng)刷新界面通知用戶遠(yuǎn)端請(qǐng)求轉(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;
     
  6. 被請(qǐng)求方UI調(diào)用tsdk_reply_add_video()接口來處理轉(zhuǎn)視頻請(qǐng)求，參數(shù)為呼叫標(biāo)識(shí)call_id和is_accept標(biāo)識(shí)。接收轉(zhuǎn)視頻請(qǐng)求時(shí)，is_accept標(biāo)識(shí)的值為TSDK_TRUE；拒絕轉(zhuǎn)視頻請(qǐng)求時(shí)，is_accept標(biāo)識(shí)的值為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;
     
  7. 被請(qǐng)求發(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;
     
  8. 若被請(qǐng)求方接受視頻請(qǐng)求，請(qǐng)求方向UI上報(bào)打開視頻通知事件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;
     

注意事項(xiàng)

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