描述

用户可以将正在进行的音频通话保持，待需要的时候再恢复通话，能减少拨号次数，使用更方便。

音频通话已建立，主被叫正在通话中。

业务流程

图1 保持和恢复音频通话流程 

保持通话

说明： 

通话中，主被叫双方均可以发起保持通话操作。

1. 请求发起方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发送保持通话请求，与业务服务器和被请求方完成通话保持交互处理，请求方SDK向UI上报保持通话成功事件TSDK_E_CALL_EVT_HOLD_SUCCESS，对应事件数据结构TSDK_S_CALL_INFO中，TSDK_E_CALL_STATE 标识呼叫状态为TSDK_E_CALL_STATE_HOLD，UI刷新界面提示当前通话保持中，并显示恢复通话入口；被请求方UI界面不感知当前通话被保持，依然处于通话态。
   说明： 

   1. 保持通话可能由于服务器权限或当前通话业务限制，导致用户保持通话失败，此时SDK向UI上报保持通话失败事件TSDK_E_CALL_EVT_HOLD_FAILED，TSDK_S_CALL_INFO中，TSDK_E_CALL_STATE 标识呼叫状态为TSDK_E_CALL_STATE_LIVE,通话中；
   2. 在业务服务器支持播放保持提示音时，被保持方可以听到由服务器侧播放的保持提示音；
   3. 为了较优的业务体验，建议在通话保持时，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; }

恢复通话

说明： 

保持通话发起方才可进行恢复通话操作。

1. 请求发起方UI调用tsdk_unhold_call()接口恢复处于保持态的通话。
   代码示例：

   //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发送恢复通话请求，与业务服务器和被请求方完成通话恢复交互处理，请求方SDK向UI上报恢复通话成功事件TSDK_E_CALL_EVT_UNHOLD_SUCCESS，对应事件数据结构对应事件数据结构TSDK_S_CALL_INFO中，TSDK_E_CALL_STATE 标识呼叫状态为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; }

注意事项

因通话双方均可以在本端处于通话态发起保持操作，即通话可能会处于双向保持态，在任一保持方发起恢复通话时，仅能恢复本端通话状态，不会恢复对端的通话状态。