金沙娱场城官网js06(中国)有限公司

描述

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

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

业务流程

保持通话

1. 请求发起方UI调用tsdk_del_video()发起视频转音频呼叫请求，移除本地和远端视频窗口，UI界面显示为音频通话界面。
   说明：

   当前服务器暂不支持视频通话保持，需要先移除视频窗口，转换为语音通话后再保持通话。

2. 被请求方收到TSDK_E_CALL_EVT_CLOSE_VIDEO_IND关闭视频通知，移除本地和远端视频窗口，UI界面显示为音频通话界面。
3. 请求发起方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 ;

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

3. 请求发起方UI调用tsdk_add_video()发起音频转视频呼叫请求。
   代码示例：

   //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. 请求发起方UI先完成本地窗口和远端窗口创建，再调用tsdk_set_video_window()接口设置视频窗口与呼叫的绑定关系。
   代码示例：

   //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应刷新界面通知用户远端请求转视频。
   代码示例：

   //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调用tsdk_reply_add_video()接口来处理转视频请求，参数为呼叫标识call_id和is_accept标识。接收转视频请求时，is_accept标识的值为TSDK_TRUE；拒绝转视频请求时，is_accept标识的值为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. 被请求发起方UI先完成本地窗口和远端窗口创建，再调用tsdk_set_video_window()接口设置视频窗口与呼叫的绑定关系，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根据事件显示远端和近端视频窗口。
   代码示例：

   //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 ;

注意事项

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