台湾一级a毛片在线播放,黄色精品偷拍视频大全,精品一区二区在线欧美日韩,日本特黄一级视频播三级片,日韩美女18岁美女视频,偷偷操不一样的99,国产午夜激无码av毛片久

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

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

入門(mén)使用

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

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

描述

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

視頻通話(huà)已建立,主被叫正在通話(huà)中。

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

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

保持通話(huà)

說(shuō)明: 

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

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

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

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

  2. 被請(qǐng)求方收到TSDK_E_CALL_EVT_CLOSE_VIDEO_IND關(guān)閉視頻通知,移除本地和遠(yuǎn)端視頻窗口,UI界面顯示為音頻通話(huà)界面。
  3. 請(qǐng)求發(fā)起方UI調(diào)用tsdk_hold_call()接口保持通話(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;
    
     
  4. 請(qǐng)求方SDK發(fā)送保持通話(huà)請(qǐng)求,與業(yè)務(wù)服務(wù)器和被請(qǐng)求方完成通話(huà)保持交互處理,請(qǐng)求方SDK向UI上報(bào)保持通話(huà)成功事件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)為T(mén)SDK_E_CALL_STATE_HOLD,UI刷新界面提示當(dāng)前通話(huà)保持中,并顯示恢復(fù)通話(huà)入口;
    說(shuō)明: 
    1. 保持通話(huà)可能由于服務(wù)器權(quán)限或當(dāng)前通話(huà)業(yè)務(wù)限制,導(dǎo)致用戶(hù)保持通話(huà)失敗,此時(shí)SDK向UI上報(bào)保持通話(huà)失敗事件TSDK_E_CALL_EVT_HOLD_FAILED,TSDK_S_CALL_INFO中,TSDK_E_CALL_STATE 標(biāo)識(shí)呼叫狀態(tài)為T(mén)SDK_E_CALL_STATE_LIVE,通話(huà)中;
    2. 在業(yè)務(wù)服務(wù)器支持播放保持提示音時(shí),被保持方可以聽(tīng)到由服務(wù)器側(cè)播放的保持提示音;
    3. 為了較優(yōu)的業(yè)務(wù)體驗(yàn),建議在通話(huà)保持時(shí),UI屏蔽掛斷通話(huà)入口。
    代碼示例:
    //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à)

說(shuō)明: 

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

  1. 請(qǐng)求發(fā)起方UI調(diào)用tsdk_unhold_call()接口恢復(fù)處于保持態(tài)的通話(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;
    
     
  2. 請(qǐng)求方SDK發(fā)送恢復(fù)通話(huà)請(qǐng)求,與業(yè)務(wù)服務(wù)器和被請(qǐng)求方完成通話(huà)恢復(fù)交互處理,請(qǐng)求方SDK向UI上報(bào)恢復(fù)通話(huà)成功事件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)為T(mén)SDK_E_CALL_STATE_LIVE,UI刷新界面顯示通話(huà)中。
    說(shuō)明: 

    恢復(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;
    }
    
     
  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)刷新界面通知用戶(hù)遠(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()接口來(lái)處理轉(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í)的值為T(mén)SDK_TRUE;拒絕轉(zhuǎn)視頻請(qǐng)求時(shí),is_accept標(biāo)識(shí)的值為T(mén)SDK_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)打開(kāi)視頻通知事件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)

因通話(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)視頻。