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

智慧服務，成就美好體驗 項目咨詢

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

入門使用

保持和恢復音頻通話

更新時間：2019-11-20

描述

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

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

業(yè)務流程

圖1 保持和恢復音頻通話流程 

保持通話

說明： 

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

  1. 請求發(fā)起方UI調用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è)務服務器和被請求方完成通話保持交互處理，請求方SDK向UI上報保持通話成功事件TSDK_E_CALL_EVT_HOLD_SUCCESS，對應事件數據結構TSDK_S_CALL_INFO中，TSDK_E_CALL_STATE 標識呼叫狀態(tài)為TSDK_E_CALL_STATE_HOLD，UI刷新界面提示當前通話保持中，并顯示恢復通話入口；被請求方UI界面不感知當前通話被保持，依然處于通話態(tài)。
    說明： 
    1. 保持通話可能由于服務器權限或當前通話業(yè)務限制，導致用戶保持通話失敗，此時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è)務服務器支持播放保持提示音時，被保持方可以聽到由服務器側播放的保持提示音；
    3. 為了較優(yōu)的業(yè)務體驗，建議在通話保持時，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ā)起方才可進行恢復通話操作。

  1. 請求發(fā)起方UI調用tsdk_unhold_call()接口恢復處于保持態(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ā)送恢復通話請求，與業(yè)務服務器和被請求方完成通話恢復交互處理，請求方SDK向UI上報恢復通話成功事件TSDK_E_CALL_EVT_UNHOLD_SUCCESS，對應事件數據結構對應事件數據結構TSDK_S_CALL_INFO中，TSDK_E_CALL_STATE 標識呼叫狀態(tài)為TSDK_E_CALL_STATE_LIVE，UI刷新界面顯示通話中。
    說明： 

    恢復通話可能由于網絡側極低概率的沖突或異常，導致用戶恢復通話失敗，此時SDK向UI上報恢復通話失敗事件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ā)起恢復通話時，僅能恢復本端通話狀態(tài)，不會恢復對端的通話狀態(tài)。