智慧服务，成就美好体验 项目咨询

主页 > 服务与支持 > 开发平台 > 客户端SDK参考 > Android Native SDK > 音视频呼叫 保持和恢复音频通话

入门使用

保持和恢复音频通话

更新时间：2019-11-20

描述

用户可以将正在进行的音频通话保持，待需要的时候再恢复通话，能减少拨号次数，使用更方便。

前提条件

音频通话已建立，主被叫正在通话中。

业务流程

图1 保持和恢复音频通话流程 

保持通话

说明： 

通话中，主被叫双方均可以发起保持通话操作。

  1. 请求发起方UI调用TsdkCall对象中的holdCall()方法保持通话。

     

    代码示例： 
    //Java code
public boolean holdCall()
{
    int result = tsdkCall.holdCall();
    if (result != 0)
    {
        LogUtil.e(TAG, "holdCall return failed, result = " + result);
        return false;
    }
    return true;
}
     

     

  2. 请求方SDK发送保持通话请求，与业务服务器和被请求方完成通话保持交互处理。请求方SDK通过TsdkNotify对象中的onEvtHoldSuccess()方法向UI上报保持通话成功事件， 呼叫状态为保持。UI刷新界面提示当前通话保持中，并显示恢复通话入口。被请求方UI界面不感知当前通话被保持，依然处于通话态。

     

    说明： 
    • 保持通话可能由于服务器权限或当前通话业务限制，导致用户保持通话失败，此时SDK通过TsdkNotify对象中的onEvtHoldFailed()方法向UI上报保持通话失败事件，通话状态为通话中。
    • 在业务服务器支持播放保持提示音时，被保持方可以听到由服务器侧播放的保持提示音。
    • 为了较优的业务体验，建议在通话保持时，UI屏蔽挂断通话入口。

    代码示例：

    //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);
    }
}
     

     

恢复通话

说明： 

保持通话发起方才可进行恢复通话操作。

  1. 请求发起方UI调用TsdkCall对象中的unholdCall()方法恢复处于保持态的通话。

     

    代码示例： 
    //Java code
public boolean unHoldCall()
{
    int result = tsdkCall.unholdCall();
    if (result != 0)
    {
        LogUtil.e(TAG, "unholdCall return failed, result = " + result);
        return false;
    }
    return true;
}
     

     

  2. 请求方SDK发送恢复通话请求，与业务服务器和被请求方完成通话恢复交互处理。请求方SDK通过TsdkNotify对象中的onEvtUnholdSuccess()方法向UI上报恢复通话成功事件，呼叫状态为“通话中”，UI刷新界面显示通话中。

     

    说明： 

    恢复通话可能由于网络侧极低概率的冲突或异常，导致用户恢复通话失败，此时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);
}
     

     

注意事项

因通话双方均可以在本端处于通话态发起保持操作，即通话可能会处于双向保持态，在任一保持方发起恢复通话时，仅能恢复本端通话状态，不会恢复对端的通话状态。