描述

用戶可以將正在進(jìn)行的視頻通話保持，待需要的時(shí)候再恢復(fù)通話，能減少撥號(hào)次數(shù)，使用更方便。

說(shuō)明：

保持和恢復(fù)視頻通話，與“保持和恢復(fù)音頻通話”流程基本相同，不同在于通話被保持時(shí)，視頻將會(huì)自動(dòng)被關(guān)閉，恢復(fù)時(shí)，視頻將會(huì)自動(dòng)打開(kāi)。

前提條件

視頻通話已建立，主被叫正在通話中。

業(yè)務(wù)流程

圖1 保持和恢復(fù)視頻通話流程
點(diǎn)擊放大

保持通話

說(shuō)明：

通話中，主被叫雙方均可以發(fā)起保持通話操作。

請(qǐng)求發(fā)起方UI調(diào)用TsdkCall對(duì)象中的delVideo()方法發(fā)起視頻轉(zhuǎn)音頻呼叫請(qǐng)求，移除本地和遠(yuǎn)端視頻窗口，UI界面顯示為音頻通話界面。

說(shuō)明：

當(dāng)前服務(wù)器暫不支持視頻通話保持，需要先移除視頻窗口，轉(zhuǎn)換為語(yǔ)音通話后再保持通話。

代碼示例：

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

													 

被請(qǐng)求方SDK收到請(qǐng)求后，自動(dòng)進(jìn)行視頻轉(zhuǎn)音頻交互處理。通過(guò)TsdkNotify對(duì)象中的onEvtCloseVideoInd()方法向UI上報(bào)對(duì)方請(qǐng)求關(guān)閉視頻通知，移除本地和遠(yuǎn)端視頻窗口，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();
    }
}

												 

請(qǐng)求發(fā)起方UI調(diào)用TsdkCall對(duì)象中的holdCall()方法保持通話。
請(qǐng)求方SDK發(fā)送保持通話請(qǐng)求，與業(yè)務(wù)服務(wù)器和被請(qǐng)求方完成通話保持交互處理。請(qǐng)求方SDK通過(guò)TsdkNotify對(duì)象中的onEvtHoldSuccess()方法向UI上報(bào)保持通話成功事件，呼叫狀態(tài)為保持，UI刷新界面提示當(dāng)前通話保持中，并顯示恢復(fù)通話入口。被請(qǐng)求方UI界面不感知當(dāng)前通話被保持，依然處于通話態(tài)。
說(shuō)明：
- 保持通話可能由于服務(wù)器權(quán)限或當(dāng)前通話業(yè)務(wù)限制，導(dǎo)致用戶保持通話失敗，此時(shí)SDK通過(guò)TsdkNotify對(duì)象中的onEvtHoldFailed()方法向UI上報(bào)保持通話失敗事件，通話狀態(tài)為通話中。
- 在業(yè)務(wù)服務(wù)器支持播放保持提示音時(shí)，被保持方可以聽(tīng)到由服務(wù)器側(cè)播放的保持提示音。
- 為了較優(yōu)的業(yè)務(wù)體驗(yàn)，建議在通話保持時(shí)，UI屏蔽掛斷通話入口。

恢復(fù)通話

說(shuō)明：

保持通話發(fā)起方才可進(jìn)行恢復(fù)通話操作。

請(qǐng)求發(fā)起方UI調(diào)用TsdkCall對(duì)象中的unholdCall()方法恢復(fù)處于保持態(tài)的通話。
請(qǐng)求方SDK發(fā)送恢復(fù)通話請(qǐng)求，與業(yè)務(wù)服務(wù)器和被請(qǐng)求方完成通話恢復(fù)交互處理。請(qǐng)求方SDK通過(guò)TsdkNotify對(duì)象中的onEvtUnholdSuccess()方法向UI上報(bào)恢復(fù)通話成功事件，呼叫狀態(tài)為“通話中”，UI刷新界面顯示通話中。

說(shuō)明：

恢復(fù)通話可能由于網(wǎng)絡(luò)側(cè)極低概率的沖突或異常，導(dǎo)致用戶恢復(fù)通話失敗，此時(shí)SDK通過(guò)TsdkNotify對(duì)象中的onEvtUnholdFailed() 向UI上報(bào)取消保持通話失敗事件，并自動(dòng)掛斷通話。

請(qǐng)求發(fā)起方UI先完成本地窗口和遠(yuǎn)端窗口創(chuàng)建，再調(diào)用TsdkCall對(duì)象中的setVideoWindow()方法設(shè)置視頻窗口信息。

代碼示例：

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

													 

請(qǐng)求發(fā)起方UI調(diào)用TsdkCall對(duì)象中的addVideo()方法發(fā)起音頻轉(zhuǎn)視頻呼叫請(qǐng)求。

代碼示例：

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

													 

被請(qǐng)求方SDK收到請(qǐng)求后，通過(guò)TsdkNotify對(duì)象中的onEvtOpenVideoReq()方法向UI上報(bào)對(duì)方請(qǐng)求音頻轉(zhuǎn)視頻事件，UI應(yīng)刷新界面通知用戶遠(yuǎn)端請(qǐng)求轉(zhuǎn)視頻。

代碼示例：

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

}

													 

被請(qǐng)求方接受轉(zhuǎn)視頻請(qǐng)求，UI先完成本地窗口和遠(yuǎn)端窗口創(chuàng)建，再調(diào)用TsdkCall對(duì)象中的setVideoWindow()方法設(shè)置視頻窗口信息。

說(shuō)明：

只有被請(qǐng)求方用戶接受時(shí)，才需要此步驟。

若用戶長(zhǎng)時(shí)間沒(méi)有響應(yīng)，被請(qǐng)求端應(yīng)用程序應(yīng)該自動(dòng)拒絕轉(zhuǎn)視頻的請(qǐng)求。建議時(shí)間為45s。

被請(qǐng)求方UI調(diào)用TsdkCall對(duì)象中的replyAddVideo()方法接受轉(zhuǎn)視頻請(qǐng)求。

說(shuō)明：

參數(shù)“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完成視頻轉(zhuǎn)音頻信令和媒體交互處理。

若被請(qǐng)求方接受視頻請(qǐng)求，主叫SDK通過(guò)TsdkNotify對(duì)象中的onEvtOpenVideoInd()方法向UI上報(bào)打開(kāi)視頻通知事件，主叫UI根據(jù)事件顯示遠(yuǎn)端和近端視頻窗口，被請(qǐng)求方點(diǎn)擊接受后，被叫UI顯示遠(yuǎn)端和近端視頻窗口。
若被請(qǐng)求方拒絕視頻請(qǐng)求，主叫SDK通過(guò)TsdkNotify對(duì)象中的onEvtRefuseOpenVideoInd()方法向UI上報(bào)遠(yuǎn)端拒絕請(qǐng)求打開(kāi)視頻通知事件，主叫UI銷毀遠(yuǎn)端和近端視頻窗口。

代碼示例：

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

}

注意事項(xiàng)

因通話雙方均可以在本端處于通話態(tài)發(fā)起保持操作，即通話可能會(huì)處于雙向保持態(tài)，在任一保持方發(fā)起恢復(fù)通話時(shí)，僅能恢復(fù)本端通話狀態(tài)，不會(huì)恢復(fù)對(duì)端的通話狀態(tài)。視頻通話雙向保持中任一方先恢復(fù)通話，不會(huì)自動(dòng)打開(kāi)視頻。

黄h片网址在线观看,五月婷婷网址,一级一级一级毛片免费毛片,欧美一级视频免费观看

入門使用

保持和恢復(fù)視頻通話

描述

前提條件

業(yè)務(wù)流程

注意事項(xiàng)