暖暖视频免费观**,国产免费美女被艹视频,毛片一级毛片,不卡三级

智慧服務(wù),成就美好體驗 項目咨詢

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

入門使用

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

更新時間:2019-11-20

描述

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

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

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

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

保持通話

說明: 

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

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

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

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

  2. 被請求方收到TSDK_E_CALL_EVT_CLOSE_VIDEO_IND關(guān)閉視頻通知,移除本地和遠端視頻窗口,UI界面顯示為音頻通話界面。
  3. 請求發(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. 請求方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ù)通話入口;
    說明: 
    1. 保持通話可能由于服務(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,通話中;
    2. 在業(yè)務(wù)服務(wù)器支持播放保持提示音時,被保持方可以聽到由服務(wù)器側(cè)播放的保持提示音;
    3. 為了較優(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ā)起方才可進行恢復(fù)通話操作。

  1. 請求發(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. 請求方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;
    }
    
     
  3. 請求發(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;
    
     
  4. 請求發(fā)起方UI先完成本地窗口和遠端窗口創(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. 被請求方SDK收到請求后,向UI上報對方請求增加視頻事件TSDK_E_CALL_EVT_OPEN_VIDEO_REQ,UI應(yī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. 被請求方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;
    
     
  7. 被請求發(fā)起方UI先完成本地窗口和遠端窗口創(chuàng)建,再調(diào)用tsdk_set_video_window()接口設(shè)置視頻窗口與呼叫的綁定關(guān)系,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;
    
     
  8. 若被請求方接受視頻請求,請求方向UI上報打開視頻通知事件TSDK_E_CALL_EVT_OPEN_VIDEO_IND,UI根據(jù)事件顯示遠端和近端視頻窗口。
    代碼示例:
    //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ù)通話,不會自動打開視頻。