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

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

入门使用

建立音频通话

更新时间：2019-11-20

描述

主被叫建立音频通话。

前提条件

主被叫客户端均已注册。

业务流程

图1 建立音频通话流程 
  1. 主叫UI调用TsdkCallManager的startCall()方法发起音频呼叫，传入参数包含被叫号码和是否发起视频呼叫，返回参数为呼叫对象(TsdkCall)。

     

    说明： 

    呼叫ID作为一路通话的唯一标识，UI应保存并管理，以用于后继的呼叫相关操作。

    代码示例： 
    //Java code
TsdkCall call = TsdkManager.getInstance().getCallManager().startCall(toNumber, isVideoCall);
     

     

  2. 主叫SDK完成状态自检，准备呼叫请求消息，向UI上报呼出事件发起呼叫结果事件onEvtCallStartResult。
  3. 主叫SDK发出呼叫请求消息，向UI上报呼出事件onEvtCallOutgoing；被叫SDK收到呼叫请求消息，向UI上报来电事件onEvtCallIncoming。通知事件携带参数TsdkCall，包含远端号码、呼叫类型和呼叫状态等呼叫信息。

     

    代码示例： 
    //Java code
public void onEvtCallIncoming(TsdkCall call, Boolean maybeVideoCall){
    Log.i(TAG, "onCallComing");
    if (null == call)
    {
        Log.e(TAG, "onCallComing call is null");
        return;
    }
    Session newSession = new Session(call);
    putCallSessionToMap(newSession);

    CallInfo callInfo = getCallInfo(call);
    callInfo.setMaybeVideoCall(maybeVideoCall);

    mCallNotification.onCallEventNotify(CallConstant.CallEvent.CALL_COMING, callInfo);
}
     

     

  4. 主叫SDK在收到被叫振铃通知时，上报onEvtCallRingback事件，UI应播放本地回铃音。

     

    代码示例： 
    //Java code
//Java code
public void onEvtCallRingback(TsdkCall call){
    Log.i(TAG, "onCallRingBack");
    if (null == call)
    {
        Log.e(TAG, "onCallRingBack call is null");
        return;
    }
        if (null != mCallNotification)
        {
            mCallNotification.onCallEventNotify(CallConstant.CallEvent.PLAY_RING_BACK_TONE, null);
        }
}
     

     

  5. 被叫调用TsdkCall的answerCall()方法接听呼叫。

     

    说明： 

    被叫若拒绝呼叫参见结束通话（或呼叫）章节描述。

    代码示例： 
    //Java code
int result = tsdkCall.answerCall(iVideoCall==1? true:false);
     

     

  6. 主被叫SDK向UI上报RTP通道已建立事件onEvtCallRtpCreated。

     

    说明： 

    RTP通道已建立，可以进行一些二次拨号等操作。

    代码示例： 
    //Java code
public void onEvtCallRtpCreated(TsdkCall call){
    Log.i(TAG, "onCallRTPCreated");
    if (null == call)
    {
        Log.e(TAG, "tupCall obj is null");
        return;
    }

    CallInfo callInfo = getCallInfo(call);

    mCallNotification.onCallEventNotify(CallConstant.CallEvent.RTP_CREATED, callInfo);
}
     

     

  7. 主被叫SDK向UI上报通话建立事件onEvtCallConnected，UI刷新界面进入通话界面，主被叫双方通话。

     

    代码示例： 
    //Java code
public void onEvtCallConnected(TsdkCall call){
    Log.i(TAG, "onCallConnected");
    if (null == call)
    {
        Log.e(TAG, "call obj is null");
        return;
    }

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

    if (callInfo.isVideoCall())
    {
        callSession.setCallStatus(CallConstant.CallStatus.VIDEO_CALLING);
    }
    else
    {
        callSession.setCallStatus(CallConstant.CallStatus.AUDIO_CALLING);
    }

    mCallNotification.onCallEventNotify(CallConstant.CallEvent.CALL_CONNECTED, callInfo);
}