入門使用
保持和恢復(fù)視頻通話
更新時(shí)間：2019-11-20
描述
用戶可以將正在進(jìn)行的視頻通話保持，待需要的時(shí)候再恢復(fù)通話，能減少撥號(hào)次數(shù)，使用更方便。
視頻通話已建立，主被叫正在通話中。
業(yè)務(wù)流程
圖1 保持和恢復(fù)視頻通話流程
保持通話
說明：
通話中，主被叫雙方均可以發(fā)起保持通話操作。
視頻通話保持，需先移除視頻，再保持音頻通話；恢復(fù)通話，需先恢復(fù)音頻通話，再打開視頻。
-
請(qǐng)求發(fā)起方UI調(diào)用tsdk_del_video()發(fā)起視頻轉(zhuǎn)音頻呼叫請(qǐng)求，移除本地和遠(yuǎn)端視頻窗口，UI界面顯示為音頻通話界面。
說明：
當(dāng)前服務(wù)器暫不支持視頻通話保持，需要先移除視頻窗口，轉(zhuǎn)換為語音通話后再保持通話。
- 被請(qǐng)求方收到TSDK_E_CALL_EVT_CLOSE_VIDEO_IND關(guān)閉視頻通知，移除本地和遠(yuǎn)端視頻窗口，UI界面顯示為音頻通話界面。
-
請(qǐng)求發(fā)起方UI調(diào)用tsdk_hold_call()接口保持通話。
代碼示例：
-(BOOL)holdCallWithCallId:(unsigned int)callId { TSDK_RESULT ret = tsdk_hold_call(callId); DDLogInfo(@"Call_Log: tsdk_hold_call = %@",(TSDK_SUCCESS == ret)?@"YES":@"NO"); return ret == TSDK_SUCCESS ? YES : NO; } -
請(qǐng)求方SDK發(fā)送保持通話請(qǐng)求，與業(yè)務(wù)服務(wù)器和被請(qǐng)求方完成通話保持交互處理，請(qǐng)求方SDK向UI上報(bào)保持通話成功事件TSDK_E_CALL_EVT_HOLD_SUCCESS，對(duì)應(yīng)事件數(shù)據(jù)結(jié)構(gòu)TSDK_S_CALL_INFO中，TSDK_E_CALL_STATE 標(biāo)識(shí)呼叫狀態(tài)為TSDK_E_CALL_STATE_HOLD，UI刷新界面提示當(dāng)前通話保持中，并顯示恢復(fù)通話入口；
說明：
- 保持通話可能由于服務(wù)器權(quán)限或當(dāng)前通話業(yè)務(wù)限制，導(dǎo)致用戶保持通話失敗，此時(shí)SDK向UI上報(bào)保持通話失敗事件TSDK_E_CALL_EVT_HOLD_FAILED，TSDK_S_CALL_INFO中，TSDK_E_CALL_STATE 標(biāo)識(shí)呼叫狀態(tài)為TSDK_E_CALL_STATE_LIVE,通話中；
- 在業(yè)務(wù)服務(wù)器支持播放保持提示音時(shí)，被保持方可以聽到由服務(wù)器側(cè)播放的保持提示音；
- 為了較優(yōu)的業(yè)務(wù)體驗(yàn)，建議在通話保持時(shí)，UI屏蔽掛斷通話入口。
代碼示例：case TSDK_E_CALL_EVT_HOLD_SUCCESS: { DDLogInfo(@"TSDK_E_CALL_EVT_HOLD_SUCCESS"); NSDictionary *resultInfo = @{ TSDK_CALL_HOLD_RESULT_KEY:[NSNumber numberWithBool:YES], CALL_ID : callId }; [self respondsCallDelegateWithType:CALL_HOLD_RESULT result:resultInfo]; break; }
恢復(fù)通話
說明：
保持通話發(fā)起方才可進(jìn)行恢復(fù)通話操作。
-
請(qǐng)求發(fā)起方UI調(diào)用tsdk_unhold_call()接口恢復(fù)處于保持態(tài)的通話。
代碼示例：
-(BOOL)unHoldCallWithCallId:(unsigned int)callId { TSDK_RESULT ret = tsdk_unhold_call(callId); return ret == TSDK_SUCCESS ? YES : NO; } -
請(qǐng)求方SDK發(fā)送恢復(fù)通話請(qǐng)求，與業(yè)務(wù)服務(wù)器和被請(qǐng)求方完成通話恢復(fù)交互處理，請(qǐng)求方SDK向UI上報(bào)恢復(fù)通話成功事件TSDK_E_CALL_EVT_UNHOLD_SUCCESS，對(duì)應(yīng)事件數(shù)據(jù)結(jié)構(gòu)對(duì)應(yīng)事件數(shù)據(jù)結(jié)構(gòu)TSDK_S_CALL_INFO中，TSDK_E_CALL_STATE 標(biāo)識(shí)呼叫狀態(tài)為TSDK_E_CALL_STATE_LIVE，UI刷新界面顯示通話中。
說明：
恢復(fù)通話可能由于網(wǎng)絡(luò)側(cè)極低概率的沖突或異常，導(dǎo)致用戶恢復(fù)通話失敗，此時(shí)SDK向UI上報(bào)恢復(fù)通話失敗事件TSDK_E_CALL_EVT_UNHOLD_FAILED，并自動(dòng)掛斷通話。
代碼示例：case TSDK_E_CALL_EVT_UNHOLD_SUCCESS: { DDLogInfo(@"TSDK_E_CALL_EVT_UNHOLD_SUCCESS"); NSDictionary *resultInfo = @{ TSDK_CALL_UNHOLD_RESULT_KEY:[NSNumber numberWithBool:YES], CALL_ID : callId }; [self respondsCallDelegateWithType:CALL_UNHOLD_RESULT result:resultInfo]; break; } -
請(qǐng)求發(fā)起方UI調(diào)用tsdk_add_video()發(fā)起音頻轉(zhuǎn)視頻呼叫請(qǐng)求。
代碼示例：
-(BOOL)upgradeAudioToVideoCallWithCallId:(unsigned int)callId { TSDK_RESULT ret = tsdk_add_video((TSDK_UINT32)callId); DDLogInfo(@"Call_Log: tsdk_add_video = %d",ret); return ret == TSDK_SUCCESS ? YES : NO; } -
請(qǐng)求發(fā)起方UI先完成本地窗口和遠(yuǎn)端窗口創(chuàng)建，再調(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); } -
被請(qǐng)求方SDK收到請(qǐng)求后，向UI上報(bào)對(duì)方請(qǐng)求增加視頻事件TSDK_E_CALL_EVT_OPEN_VIDEO_REQ，UI應(yīng)刷新界面通知用戶遠(yuǎn)端請(qǐng)求轉(zhuǎn)視頻。
代碼示例：
case TSDK_E_CALL_EVT_OPEN_VIDEO_REQ: { NSString *callId = [NSString stringWithFormat:@"%d",notify.param1]; NSDictionary *callUpgradePassiveInfo = [NSDictionary dictionaryWithObjectsAndKeys:callId,CALL_ID,nil]; [self respondsCallDelegateWithType:CALL_UPGRADE_VIDEO_PASSIVE result:callUpgradePassiveInfo]; DDLogInfo(@"Call_Log: call revice CALL_E_EVT_CALL_ADD_VIDEO"); break; } -
被請(qǐng)求方UI調(diào)用tsdk_reply_add_video()接口來處理轉(zhuǎn)視頻請(qǐng)求，參數(shù)為呼叫標(biāo)識(shí)call_id和is_accept標(biāo)識(shí)。接收轉(zhuǎn)視頻請(qǐng)求時(shí)，is_accept標(biāo)識(shí)的值為TSDK_TRUE；拒絕轉(zhuǎn)視頻請(qǐng)求時(shí)，is_accept標(biāo)識(shí)的值為TSDK_FALSE。
代碼示例：
-(BOOL)replyAddVideoCallIsAccept:(BOOL)accept callId:(unsigned int)callId { TSDK_BOOL isAccept = accept; TSDK_RESULT ret = tsdk_reply_add_video((TSDK_UINT32)callId , isAccept); return ret == TSDK_SUCCESS ? YES : NO; } -
被請(qǐng)求發(fā)起方UI先完成本地窗口和遠(yuǎn)端窗口創(chuàng)建，再調(diào)用tsdk_set_video_window()接口設(shè)置視頻窗口與呼叫的綁定關(guān)系，UI顯示遠(yuǎ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); } -
若被請(qǐng)求方接受視頻請(qǐng)求，請(qǐng)求方向UI上報(bào)打開視頻通知事件TSDK_E_CALL_EVT_OPEN_VIDEO_IND，UI根據(jù)事件顯示遠(yuǎn)端和近端視頻窗口。
代碼示例：
case TSDK_E_CALL_EVT_OPEN_VIDEO_IND: { NSString *callId = [NSString stringWithFormat:@"%d",notify.param1]; NSDictionary *callUpgradePassiveInfo = [NSDictionary dictionaryWithObjectsAndKeys:callId,CALL_ID,nil]; [self respondsCallDelegateWithType:CALL_REFUSE_OPEN_VIDEO result:callUpgradePassiveInfo]; DDLogInfo(@"Call_Log: call CALL_E_EVT_CALL_DEL_VIDEO"); break; }
注意事項(xiàng)
因通話雙方均可以在本端處于通話態(tài)發(fā)起保持操作，即通話可能會(huì)處于雙向保持態(tài)，在任一保持方發(fā)起恢復(fù)通話時(shí)，僅能恢復(fù)本端通話狀態(tài)，不會(huì)恢復(fù)對(duì)端的通話狀態(tài)；視頻通話雙向保持中任一方先恢復(fù)通話，不會(huì)自動(dòng)打開視頻。
