描述

用户点对点音频通话。

主被叫客户端均已注册。

业务流程

图1 建立音频通话流程 

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

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

   代码示例：

   //c code TSDK_RESULT ret; ret = tsdk_start_call(&callid, call_number, FALSE); if (TSDK_SUCCESS != ret) { LOG_D_CALL_ERROR("start call failed. result=%#x", ret); return -1; } return TSDK_SUCCESS;

2. 主叫SDK完成状态自检，准备呼叫请求消息，向UI上报呼出事件发起呼叫结果事件TSDK_E_CALL_EVT_CALL_START_RESULT。
3. 主叫SDK发出呼叫请求消息，向UI上报呼出事件CALL_E_EVT_CALL_OUTGOING；被叫SDK收到呼叫请求消息，向UI上报来电事件CALL_E_EVT_CALL_INCOMING。通知事件携带参数callid标识本次呼叫，对应的事件数据结构中CALL_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; }

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

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

5. 被叫调用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;

6. 主被叫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; }

7. 主被叫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; }

注意事项

无。