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

智慧服務(wù),成就美好體驗(yàn) 項(xiàng)目咨詢

主頁 > 服務(wù)與支持 > 開發(fā)平臺 > 客戶端SDK參考 > Android Native SDK > 音視頻呼叫 保持和恢復(fù)音頻通話

入門使用

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

更新時(shí)間:2019-11-20

描述

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

前提條件

音頻通話已建立,主被叫正在通話中。

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

圖1 保持和恢復(fù)音頻通話流程 

保持通話

說明: 

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

  1. 請求發(fā)起方UI調(diào)用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發(fā)送保持通話請求,與業(yè)務(wù)服務(wù)器和被請求方完成通話保持交互處理。請求方SDK通過TsdkNotify對象中的onEvtHoldSuccess()方法向UI上報(bào)保持通話成功事件, 呼叫狀態(tài)為保持。UI刷新界面提示當(dāng)前通話保持中,并顯示恢復(fù)通話入口。被請求方UI界面不感知當(dāng)前通話被保持,依然處于通話態(tài)。

     

    說明: 
    • 保持通話可能由于服務(wù)器權(quán)限或當(dāng)前通話業(yè)務(wù)限制,導(dǎo)致用戶保持通話失敗,此時(shí)SDK通過TsdkNotify對象中的onEvtHoldFailed()方法向UI上報(bào)保持通話失敗事件,通話狀態(tài)為通話中。
    • 在業(yè)務(wù)服務(wù)器支持播放保持提示音時(shí),被保持方可以聽到由服務(wù)器側(cè)播放的保持提示音。
    • 為了較優(yōu)的業(yè)務(wù)體驗(yàn),建議在通話保持時(shí),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失敗,不自動動恢復(fù)視頻
            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ù)通話

說明: 

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

  1. 請求發(fā)起方UI調(diào)用TsdkCall對象中的unholdCall()方法恢復(fù)處于保持態(tài)的通話。

     

    代碼示例:
    //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發(fā)送恢復(fù)通話請求,與業(yè)務(wù)服務(wù)器和被請求方完成通話恢復(fù)交互處理。請求方SDK通過TsdkNotify對象中的onEvtUnholdSuccess()方法向UI上報(bào)恢復(fù)通話成功事件,呼叫狀態(tài)為“通話中”,UI刷新界面顯示通話中。

     

    說明: 

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

    代碼示例:

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

     

注意事項(xiàng)

因通話雙方均可以在本端處于通話態(tài)發(fā)起保持操作,即通話可能會處于雙向保持態(tài),在任一保持方發(fā)起恢復(fù)通話時(shí),僅能恢復(fù)本端通話狀態(tài),不會恢復(fù)對端的通話狀態(tài)。