入門使用
建立視頻通話
更新時(shí)間：2019-11-20
描述
用戶點(diǎn)對點(diǎn)視頻通話。
主被叫客戶端均已注冊。
業(yè)務(wù)流程
圖1 建立視頻通話流程
-
主叫UI調(diào)用tsdk_start_call()接口發(fā)起視頻呼叫，傳入?yún)?shù)包含被叫號(hào)碼和是否發(fā)起視頻呼叫，返回參數(shù)call_id標(biāo)識(shí)本次呼叫ID。
說明：
呼叫ID作為一路通話的唯一標(biāo)識(shí)，UI應(yīng)保存并管理，以用于后繼的呼叫相關(guān)操作。
代碼示例：TSDK_BOOL isVideo = ((TSDK_CALL_E_CALL_TYPE)callType==CALL_VIDEO)?TSDK_TRUE:TSDK_FALSE; TSDK_UINT32 callid = 0; TSDK_RESULT ret = tsdk_start_call(&callid,(TSDK_CHAR*)[number UTF8String], isVideo);
-
主叫發(fā)起視頻呼叫后，就調(diào)用tsdk_set_video_window()接口設(shè)置視頻窗口與呼叫的綁定關(guān)系。
代碼示例：
- (BOOL)updateVideoWindowWithLocal:(id)localVideoView andRemote:(id)remoteVideoView andBFCP:(id)bfcpVideoView callId:(unsigned int)callId { TSDK_S_VIDEO_WND_INFO videoInfo[3]; memset_s(videoInfo, sizeof(TSDK_S_VIDEO_WND_INFO) * 2, 0, sizeof(TSDK_S_VIDEO_WND_INFO) * 2); videoInfo[0].video_wnd_type = TSDK_E_VIDEO_WND_LOCAL; videoInfo[0].render = (TSDK_UPTR)localVideoView; videoInfo[0].display_mode = TSDK_E_VIDEO_WND_DISPLAY_FULL; videoInfo[1].video_wnd_type = TSDK_E_VIDEO_WND_REMOTE; videoInfo[1].render = (TSDK_UPTR)remoteVideoView; videoInfo[1].display_mode = TSDK_E_VIDEO_WND_DISPLAY_CUT; videoInfo[2].video_wnd_type = TSDK_E_VIDEO_WND_AUX_DATA; videoInfo[2].render = (TSDK_UPTR)bfcpVideoView; TSDK_RESULT ret; videoInfo[2].display_mode = TSDK_E_VIDEO_WND_DISPLAY_CUT; ret = tsdk_set_video_window((TSDK_UINT32)callId, 3, videoInfo); DDLogInfo(@"Call_Log: tsdk_set_video_window = %d",ret); [self updateVideoRenderInfoWithVideoIndex:CameraIndexFront withRenderType:TSDK_E_VIDEO_WND_LOCAL andCallId:callId]; [self updateVideoRenderInfoWithVideoIndex:CameraIndexFront withRenderType:TSDK_E_VIDEO_WND_REMOTE andCallId:callId]; return (TSDK_SUCCESS == ret); } - 主叫SDK發(fā)出呼叫請求消息，向UI上報(bào)發(fā)起呼叫結(jié)果事件TSDK_E_CALL_EVT_CALL_START_RESULT。
-
主叫SDK發(fā)出呼叫請求消息，向UI上報(bào)呼出事件TSDK_E_CALL_EVT_CALL_OUTGOING；被叫SDK收到呼叫請求消息，向UI上報(bào)來電事件TSDK_E_CALL_EVT_CALL_INCOMING，通知事件攜帶參數(shù)call_id標(biāo)識(shí)本次呼叫，對應(yīng)的事件數(shù)據(jù)結(jié)構(gòu)中TSDK_S_CALL_INFO包含對端號(hào)碼、是否是視頻呼叫和呼叫狀態(tài)等呼叫信息。
代碼示例：
case TSDK_E_CALL_EVT_CALL_INCOMING: { TSDK_S_CALL_INFO *callInfo = (TSDK_S_CALL_INFO *)notify.data; CallInfo *tsdkCallInfo = [CallInfo transfromFromCallInfoStract:callInfo]; [self resetUCVideoOrientAndIndexWithCallId:0]; NSString *callId = [NSString stringWithFormat:@"%d", callInfo->call_id]; [_tsdkCallInfoDic setObject:tsdkCallInfo forKey:callId]; NSDictionary *resultInfo = @{ TSDK_CALL_INFO_KEY : tsdkCallInfo }; [self respondsCallDelegateWithType:CALL_INCOMMING result:resultInfo]; } -
主叫SDK在收到被叫振鈴?fù)ㄖ獣r(shí)，上報(bào)TSDK_E_CALL_EVT_CALL_RINGBACK事件，UI應(yīng)播放本地回鈴音。
代碼示例：
case TSDK_E_CALL_EVT_CALL_RINGBACK: { NSDictionary *resultInfo = @{ TSDK_CALL_RINGBACK_KEY : [NSNumber numberWithBool:true] }; [self respondsCallDelegateWithType:CALL_RINGBACK result:resultInfo]; break; } -
被叫調(diào)用tsdk_accept_call()接聽呼叫。
代碼示例：
- (BOOL) answerComingCallType:(TUP_CALL_TYPE)callType callId:(unsigned int)callId { TSDK_RESULT ret = tsdk_accept_call((TSDK_UINT32)callId, callType == CALL_AUDIO ? TSDK_FALSE : TSDK_TRUE); DDLogInfo(@"Call_Log:answer call type is %d,result is %d, callid: %d",callType,ret,callId); return ret == TSDK_SUCCESS ? YES : NO; } -
被叫用戶若視頻接聽，UI先完成本地窗口和遠(yuǎn)端窗口創(chuàng)建，再調(diào)用tsdk_set_video_window()接口設(shè)置視頻窗口與呼叫的綁定關(guān)系。
說明：
被叫用戶若選擇音頻接聽，則被叫用戶無需此步驟。
-
主被叫SDK向UI上報(bào)通話建立事件TSDK_E_CALL_EVT_CALL_RTP_CREATED。
說明：
RTP通道已建立，可以進(jìn)行一些二次撥號(hào)等操作。
-
主被叫SDK向UI上報(bào)通話建立事件TSDK_E_CALL_EVT_CALL_CONNECTED，UI刷新界面進(jìn)入通話界面，主被叫雙方通話。
代碼示例：
case TSDK_E_CALL_EVT_CALL_CONNECTED: { DDLogInfo(@"Call_Log: recv call notify :CALL_E_EVT_CALL_CONNECTED"); TSDK_S_CALL_INFO *callInfo = (TSDK_S_CALL_INFO *)notify.data; CallInfo *tsdkCallInfo = [CallInfo transfromFromCallInfoStract:callInfo]; NSString *callId = [NSString stringWithFormat:@"%d", tsdkCallInfo.stateInfo.callId]; [_tsdkCallInfoDic setObject:tsdkCallInfo forKey:callId]; NSDictionary *resultInfo = @{ TSDK_CALL_INFO_KEY : tsdkCallInfo }; [self respondsCallDelegateWithType:CALL_CONNECT result:resultInfo]; }
注意事項(xiàng)
無。
