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

描述

音频通话中，通话的一方发起音频通话切换为视频通话。

前提条件

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

业务流程

通话中，主被叫双方均可以发起音频转视频操作。

图1 音频通话转视频通话流程
点击放大

请求发起方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 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);

}

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

												 

注意事项

无。

入门使用

音频通话转视频通话

描述

前提条件

业务流程

注意事项