主頁(yè) > 服務(wù)與支持 > 開發(fā)平臺(tái) > 客戶端SDK參考 > Android Native SDK > 音視頻呼叫 保持和恢復(fù)音頻通話
更新時(shí)間:2019-11-20
用戶可以將正在進(jìn)行的音頻通話保持,待需要的時(shí)候再恢復(fù)通話,能減少撥號(hào)次數(shù),使用更方便。
音頻通話已建立,主被叫正在通話中。
保持通話
通話中,主被叫雙方均可以發(fā)起保持通話操作。
//Java code public boolean holdCall() { int result = tsdkCall.holdCall(); if (result != 0) { LogUtil.e(TAG, "holdCall return failed, result = " + result); return false; } return true; } |
代碼示例:
//Java code public void onEvtHoldFailed(TsdkCall call){ Log.i(TAG, "handleHoldFailed"); CallInfo callInfo = getCallInfo(call); Session callSession = getCallSessionByCallID(callInfo.getCallID()); if (callSession.isVideoHold()) { callSession.setVideoHold(false); //保持失敗,只直接通知UI失敗,不自動(dòng)動(dòng)恢復(fù)視頻 mCallNotification.onCallEventNotify(CallConstant.CallEvent.VIDEO_HOLD_FAILED, callInfo); } else { mCallNotification.onCallEventNotify(CallConstant.CallEvent.AUDIO_HOLD_FAILED, callInfo); } } |
//Java code public void onEvtHoldSuccess(TsdkCall call){ Log.i(TAG, "handleHoldSuccess"); CallInfo callInfo = getCallInfo(call); Session callSession = getCallSessionByCallID(callInfo.getCallID()); if (callSession.isVideoHold()) { mCallNotification.onCallEventNotify(CallConstant.CallEvent.VIDEO_HOLD_SUCCESS, callInfo); } else { mCallNotification.onCallEventNotify(CallConstant.CallEvent.AUDIO_HOLD_SUCCESS, callInfo); } } |
恢復(fù)通話
保持通話發(fā)起方才可進(jìn)行恢復(fù)通話操作。
//Java code public boolean unHoldCall() { int result = tsdkCall.unholdCall(); if (result != 0) { LogUtil.e(TAG, "unholdCall return failed, result = " + result); return false; } return true; } |
恢復(fù)通話可能由于網(wǎng)絡(luò)側(cè)極低概率的沖突或異常,導(dǎo)致用戶恢復(fù)通話失敗,此時(shí)SDK通過(guò)TsdkNotify對(duì)象中的onEvtUnholdFailed() 向UI上報(bào)取消保持通話失敗事件,并自動(dòng)掛斷通話。
代碼示例:
//Java code public void onEvtUnholdSuccess(TsdkCall call){ Log.i(TAG, "handleUnholdSuccess"); int callId = call.getCallInfo().getCallId(); Session callSession = getCallSessionByCallID(callId); if (callSession == null) { Log.e(TAG, "call session obj is null"); return; } if (callSession.isVideoHold()) { addVideo(callId); callSession.setVideoHold(false); } CallInfo callInfo = getCallInfo(call); mCallNotification.onCallEventNotify(CallConstant.CallEvent.UN_HOLD_SUCCESS, callInfo); } |
//Java code public void onEvtUnholdFailed(TsdkCall call){ Log.i(TAG, "handleUnholdFailed"); CallInfo callInfo = getCallInfo(call); mCallNotification.onCallEventNotify(CallConstant.CallEvent.UN_HOLD_FAILED, callInfo); } |
因通話雙方均可以在本端處于通話態(tài)發(fā)起保持操作,即通話可能會(huì)處于雙向保持態(tài),在任一保持方發(fā)起恢復(fù)通話時(shí),僅能恢復(fù)本端通話狀態(tài),不會(huì)恢復(fù)對(duì)端的通話狀態(tài)。