描述

用户点对点视频通话。

主被叫客户端均已注册。

业务流程

图1 建立视频通话流程 

1. 主叫UI调用tsdk_start_call()接口发起视频呼叫，传入参数包含被叫号码和是否发起视频呼叫，返回参数call_id标识本次呼叫ID。
   说明： 

   呼叫ID作为一路通话的唯一标识，UI应保存并管理，以用于后继的呼叫相关操作。

   代码示例：

   //c code int result; TSDK_RESULT ret; TSDK_UINT32 call_id = 0; LOG_D_CALL_INFO("call number[%s], local video wind[%#x], remote video wind[%#x]", call_number, local_video_wnd, remote_video_wnd); result = tsdk_start_call(&call_id, call_number,TRUE); if (TSDK_SUCCESS != result) { LOG_D_CALL_ERROR("start call failed. result=%#x", result); return result; }

2. 主叫发起视频呼叫后，就调用tsdk_set_video_window()接口设置视频窗口与呼叫的绑定关系。
   代码示例：

   //c code 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(call_id, SERVICE_CALL_D_VIDEO_WINDOW_NUM, video_window_info); if (TSDK_SUCCESS != result) { LOG_D_CALL_ERROR("set video window failed. result=%#x", result); return result; } return TSDK_SUCCESS;

3. 主叫SDK发出呼叫请求消息，向UI上报发起呼叫结果事件TSDK_E_CALL_EVT_CALL_START_RESULT。
4. 主叫SDK发出呼叫请求消息，向UI上报呼出事件TSDK_E_CALL_EVT_CALL_OUTGOING；被叫SDK收到呼叫请求消息，向UI上报来电事件TSDK_E_CALL_EVT_CALL_INCOMING，通知事件携带参数call_id标识本次呼叫，对应的事件数据结构中TSDK_S_CALL_INFO包含对端号码、是否是视频呼叫和呼叫状态等呼叫信息。
   代码示例：

   //c code case TSDK_E_CALL_EVT_CALL_OUTGOING: { 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)); ::PostMessage(maindlg->GetSafeHwnd(), WM_CALL_STARTCALL, WPARAM(notifyInfo), NULL); break; } case TSDK_E_CALL_EVT_CALL_INCOMING: { 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)); ::PostMessage(maindlg->GetSafeHwnd(), WM_CALL_INCOMMING, (WPARAM)notifyInfo, NULL); break; }

5. 主叫SDK在收到被叫振铃通知时，上报TSDK_E_CALL_EVT_CALL_RINGBACK事件，UI应播放本地回铃音。
   代码示例：

   //c code case TSDK_E_CALL_EVT_CALL_RINGBACK: { LOG_D_CALL_INFO("call ringback"); break; }

6. 被叫调用tsdk_accept_call()接听呼叫。
   说明： 

   被叫若拒绝呼叫参见结束通话（或呼叫）章节描述。

   代码示例：

   //c code TSDK_RESULT ret; ret = tsdk_accept_call(callid, (TSDK_BOOL)isVideo); if (TSDK_SUCCESS != ret) { LOG_D_CALL_ERROR("accept call failed. result=%#x", ret); return -1; } return TSDK_SUCCESS;

7. 被叫用户若视频接听，UI先完成本地窗口和远端窗口创建，再调用tsdk_set_video_window()接口设置视频窗口与呼叫的绑定关系。
   说明： 

   被叫用户若选择音频接听，则被叫用户无需此步骤。

8. 主被叫SDK向UI上报通话建立事件TSDK_E_CALL_EVT_CALL_RTP_CREATED。
   说明： 

   RTP通道已建立，可以进行一些二次拨号等操作。

   代码示例：

   //c code case TSDK_E_CALL_EVT_CALL_RTP_CREATED: { LOG_D_CALL_INFO("call rtp created Event"); break; }

9. 主被叫SDK向UI上报通话建立事件TSDK_E_CALL_EVT_CALL_CONNECTED，UI刷新界面进入通话界面，主被叫双方通话。
   代码示例：

   //c code case TSDK_E_CALL_EVT_CALL_CONNECTED: { 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)); ::PostMessage(maindlg->GetSafeHwnd(), WM_CALL_CONNECTED, (WPARAM)notifyInfo, NULL); break; }

注意事项

无。