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

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

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

入門使用

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

更新時間:2019-11-20

描述

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

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

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

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

保持通話

說明: 

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

  1. 請求發(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;
    
     
  2. 請求方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 標識呼叫狀態(tài)為TSDK_E_CALL_STATE_HOLD,UI刷新界面提示當前通話保持中,并顯示恢復(fù)通話入口;被請求方UI界面不感知當前通話被保持,依然處于通話態(tài)。
    說明: 
    1. 保持通話可能由于服務(wù)器權(quán)限或當前通話業(yè)務(wù)限制,導(dǎo)致用戶保持通話失敗,此時SDK向UI上報保持通話失敗事件TSDK_E_CALL_EVT_HOLD_FAILED,TSDK_S_CALL_INFO中,TSDK_E_CALL_STATE 標識呼叫狀態(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 標識呼叫狀態(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;
    }
    
     

注意事項

因通話雙方均可以在本端處于通話態(tài)發(fā)起保持操作,即通話可能會處于雙向保持態(tài),在任一保持方發(fā)起恢復(fù)通話時,僅能恢復(fù)本端通話狀態(tài),不會恢復(fù)對端的通話狀態(tài)。