音视频呼叫_湖南轩利_为用户提供一站式的云服务及音视频整体解决方案

描述

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

说明：

保持和恢复视频通话，与“保持和恢复音频通话”流程基本相同，不同在于通话被保持时，视频将会自动被关闭，恢复时，视频将会自动打开。

前提条件

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

业务流程

图1 保持和恢复视频通话流程
点击放大

保持通话

说明：

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

请求发起方UI调用TsdkCall对象中的delVideo()方法发起视频转音频呼叫请求，移除本地和远端视频窗口，UI界面显示为音频通话界面。

说明：

当前服务器暂不支持视频通话保持，需要先移除视频窗口，转换为语音通话后再保持通话。

代码示例：

//Java code
public boolean delVideo()
{
    int result = tsdkCall.delVideo();
    if (result != 0)
    {
        LogUtil.e(TAG, "delVideo return failed, result = " + result);
        return false;
    }

    setCallStatus(CallConstant.CallStatus.AUDIO_CALLING);

    return true;
}

													 

被请求方SDK收到请求后，自动进行视频转音频交互处理。通过TsdkNotify对象中的onEvtCloseVideoInd()方法向UI上报对方请求关闭视频通知，移除本地和远端视频窗口，UI界面显示为音频通话界面。

代码示例：

//Java code
public void onEvtCloseVideoInd(TsdkCall call){
    if (null == call)
    {
        Log.e(TAG, "onCallDelVideo tupCall is null");
        return;
    }

    Session callSession = getCallSessionByCallID(call.getCallInfo().getCallId());
    if (callSession == null)
    {
        Log.e(TAG, "call session obj is null");
        return;
    }

    callSession.setCallStatus(CallConstant.CallStatus.AUDIO_CALLING);

    //Clear video data
    VideoMgr.getInstance().clearCallVideo();

    if (null != mCallNotification)
    {
        CallInfo callInfo = getCallInfo(call);
        mCallNotification.onCallEventNotify(CallConstant.CallEvent.CLOSE_VIDEO, callInfo);
    }

    if (callSession.isVideoHold())
    {
        callSession.holdCall();
    }
}

												 

请求发起方UI调用TsdkCall对象中的holdCall()方法保持通话。
请求方SDK发送保持通话请求，与业务服务器和被请求方完成通话保持交互处理。请求方SDK通过TsdkNotify对象中的onEvtHoldSuccess()方法向UI上报保持通话成功事件，呼叫状态为保持，UI刷新界面提示当前通话保持中，并显示恢复通话入口。被请求方UI界面不感知当前通话被保持，依然处于通话态。
说明：
- 保持通话可能由于服务器权限或当前通话业务限制，导致用户保持通话失败，此时SDK通过TsdkNotify对象中的onEvtHoldFailed()方法向UI上报保持通话失败事件，通话状态为通话中。
- 在业务服务器支持播放保持提示音时，被保持方可以听到由服务器侧播放的保持提示音。
- 为了较优的业务体验，建议在通话保持时，UI屏蔽挂断通话入口。

恢复通话

说明：

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

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

说明：

恢复通话可能由于网络侧极低概率的冲突或异常，导致用户恢复通话失败，此时SDK通过TsdkNotify对象中的onEvtUnholdFailed() 向UI上报取消保持通话失败事件，并自动挂断通话。

请求发起方UI先完成本地窗口和远端窗口创建，再调用TsdkCall对象中的setVideoWindow()方法设置视频窗口信息。

代码示例：

//Java code
TsdkVideoWndInfo localWndInfo = new TsdkVideoWndInfo();
localWndInfo.setVideoWndType(TsdkVideoWndType.TSDK_E_VIDEO_WND_LOCAL);
localWndInfo.setRender(ViERenderer.getIndexOfSurface(localVideoView));
localWndInfo.setDisplayMode(TsdkVideoWndDisplayMode.TSDK_E_VIDEO_WND_DISPLAY_FULL);

TsdkVideoWndInfo remoteWndInfo = new TsdkVideoWndInfo();
remoteWndInfo.setVideoWndType(TsdkVideoWndType.TSDK_E_VIDEO_WND_REMOTE);
remoteWndInfo.setRender(ViERenderer.getIndexOfSurface(remoteVideoView));
remoteWndInfo.setDisplayMode(TsdkVideoWndDisplayMode.TSDK_E_VIDEO_WND_DISPLAY_CUT);

List<TsdkVideoWndInfo> list = new ArrayList<>();
list.add(localWndInfo);
list.add(remoteWndInfo);

TsdkManager.getInstance().getCallManager().getCallByCallId(callId).setVideoWindow(list);

													 

请求发起方UI调用TsdkCall对象中的addVideo()方法发起音频转视频呼叫请求。

代码示例：

//Java code
public boolean addVideo()
{
    initVideoWindow();

    int result = tsdkCall.addVideo();
    if (result != 0)
    {
        LogUtil.e(TAG, "addVideo return failed, result = " + result);
        return false;
    }

    setCallStatus(CallConstant.CallStatus.VIDEO_CALLING);
    return true;
}

													 

被请求方SDK收到请求后，通过TsdkNotify对象中的onEvtOpenVideoReq()方法向UI上报对方请求音频转视频事件，UI应刷新界面通知用户远端请求转视频。

代码示例：

       
//Java code
public void onEvtOpenVideoReq(TsdkCall call, TsdkVideoOrientation orientType){
    Log.i(TAG, "onCallAddVideo");
    if (null == call)
    {
        Log.e(TAG, "onCallAddVideo tupCall is null");
        return;
    }

    Session callSession = getCallSessionByCallID(call.getCallInfo().getCallId());
    if (callSession == null)
    {
        Log.e(TAG, "call session obj is null");
        return;
    }

    CallConstant.CallStatus callStatus = callSession.getCallStatus();
    boolean isSupportVideo = isSupportVideo();

    if ((!isSupportVideo) || (CallConstant.CallStatus.AUDIO_CALLING != callStatus))
    {
        callSession.rejectAddVideo();
        return;
    }

    mCallNotification.onCallEventNotify(CallConstant.CallEvent.RECEIVED_REMOTE_ADD_VIDEO_REQUEST, null);

}

													 

被请求方接受转视频请求，UI先完成本地窗口和远端窗口创建，再调用TsdkCall对象中的setVideoWindow()方法设置视频窗口信息。

说明：

只有被请求方用户接受时，才需要此步骤。

若用户长时间没有响应，被请求端应用程序应该自动拒绝转视频的请求。建议时间为45s。

被请求方UI调用TsdkCall对象中的replyAddVideo()方法接受转视频请求。

说明：

参数“isAccept”表示是否接受:：“true”为同意，“false”为拒绝。

代码示例：

//Java code
public boolean acceptAddVideo()
{
    initVideoWindow();

    int result = tsdkCall.replyAddVideo(true);
    if (result != 0)
    {
        LogUtil.e(TAG, "replyAddVideo(accept) return failed, result = " + result);
        return false;
    }
    return true;
}

													 

主、被叫SDK完成视频转音频信令和媒体交互处理。

若被请求方接受视频请求，主叫SDK通过TsdkNotify对象中的onEvtOpenVideoInd()方法向UI上报打开视频通知事件，主叫UI根据事件显示远端和近端视频窗口，被请求方点击接受后，被叫UI显示远端和近端视频窗口。
若被请求方拒绝视频请求，主叫SDK通过TsdkNotify对象中的onEvtRefuseOpenVideoInd()方法向UI上报远端拒绝请求打开视频通知事件，主叫UI销毁远端和近端视频窗口。

代码示例：

//Java code
public void onEvtOpenVideoInd(TsdkCall call){
    int isVideo = call.getCallInfo().getIsVideoCall(); // 1:video, 0: audio
    int callId  = call.getCallInfo().getCallId();
    Log.i(TAG,  "isVideo: " + isVideo + "callId: " + callId);

    Session callSession = getCallSessionByCallID(callId);
    if (callSession == null)
    {
        return;
    }
    CallInfo callInfo = getCallInfo(call);//audio --> video success
    Log.i(TAG, "Upgrade To Video Call");
    VideoMgr.getInstance().setVideoOrient(callId, CallConstant.FRONT_CAMERA);

    callSession.setCallStatus(CallConstant.CallStatus.VIDEO_CALLING);
    mCallNotification.onCallEventNotify(CallConstant.CallEvent.OPEN_VIDEO, callInfo);
}

												 

//Java code
public void onEvtRefuseOpenVideoInd(TsdkCall call){

    VideoMgr.getInstance().clearCallVideo();

    Session callSession = getCallSessionByCallID(call.getCallInfo().getCallId());
    callSession.setCallStatus(CallConstant.CallStatus.AUDIO_CALLING);

    CallInfo callInfo = getCallInfo(call);
    mCallNotification.onCallEventNotify(CallConstant.CallEvent.REMOTE_REFUSE_ADD_VIDEO_SREQUEST, callInfo);

}

注意事项

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

入门使用

保持和恢复视频通话

描述

前提条件

业务流程

注意事项