更新時間:2019-11-20
用戶可以將正在進行的音頻通話保持,待需要的時候再恢復通話,能減少撥號次數(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失敗,不自動動恢復視頻 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ā)起方才可進行恢復通話操作。
//Java code public boolean unHoldCall() { int result = tsdkCall.unholdCall(); if (result != 0) { LogUtil.e(TAG, "unholdCall return failed, result = " + result); return false; } return true; } |
恢復通話可能由于網(wǎng)絡側(cè)極低概率的沖突或異常,導致用戶恢復通話失敗,此時SDK通過TsdkNotify對象中的onEvtUnholdFailed() 向UI上報取消保持通話失敗事件,并自動掛斷通話。
代碼示例:
//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ā)起保持操作,即通話可能會處于雙向保持態(tài),在任一保持方發(fā)起恢復通話時,僅能恢復本端通話狀態(tài),不會恢復對端的通話狀態(tài)。