pjsip开发——Call

呼叫使用Call来实现，一般根据需要我们需要自定义Call的实现

class MyCall extends Call {
    public VideoWindow vidWin;
    public VideoPreview vidPrev;

    MyCall(MyAccount acc, int call_id) {
        super(acc, call_id);
        vidWin = null;
    }

    @Override
    public void onCallState(OnCallStateParam prm) {
        MyApp.observer.notifyCallState(this);
        try {
            CallInfo ci = getInfo();
            if (ci.getState() ==
                    pjsip_inv_state.PJSIP_INV_STATE_DISCONNECTED) {
                this.delete();
            }
        } catch (Exception e) {
            return;
        }
    }

    @Override
    public void onCallMediaState(OnCallMediaStateParam prm) {
        CallInfo ci;
        try {
            ci = getInfo();
        } catch (Exception e) {
            return;
        }

        CallMediaInfoVector cmiv = ci.getMedia();

        for (int i = 0; i < cmiv.size(); i++) {
            CallMediaInfo cmi = cmiv.get(i);
            if (cmi.getType() == pjmedia_type.PJMEDIA_TYPE_AUDIO &&
                    (cmi.getStatus() ==
                            pjsua_call_media_status.PJSUA_CALL_MEDIA_ACTIVE ||
                            cmi.getStatus() ==
                                    pjsua_call_media_status.PJSUA_CALL_MEDIA_REMOTE_HOLD)) {
                // unfortunately, on Java too, the returned Media cannot be
                // downcasted to AudioMedia
                Media m = getMedia(i);
                AudioMedia am = AudioMedia.typecastFromMedia(m);

                // connect ports
                try {
                    MyApp.ep.audDevManager().getCaptureDevMedia().
                            startTransmit(am);
                    am.startTransmit(MyApp.ep.audDevManager().
                            getPlaybackDevMedia());
                } catch (Exception e) {
                    continue;
                }
            } else if (cmi.getType() == pjmedia_type.PJMEDIA_TYPE_VIDEO &&
                    cmi.getStatus() ==
                            pjsua_call_media_status.PJSUA_CALL_MEDIA_ACTIVE &&
                    cmi.getVideoIncomingWindowId() != pjsua2.INVALID_ID) {
                vidWin = new VideoWindow(cmi.getVideoIncomingWindowId());
                vidPrev = new VideoPreview(cmi.getVideoCapDev());
            }
        }

        MyApp.observer.notifyCallMediaState(this);
    }
}

在具体实现类中，通过重写呼叫回调，用于处理与呼叫有关的事件，如呼叫状态更改或来电转接请求。

呼叫

呼叫是一个非正式的术语，用来表示一个多媒体会话，用Call-ID来标识；不论两方通话还是在多方通话中，在每个UA中是使用同一个Call-ID.
拨出电话很简单，只需调用Call对象的makeCall（）方法即可。假设在“dest_uri”中将Account对象作为acc变量和目标URI字符串，可以使用下面的代码段发起呼出：

try {
        call.makeCall(buddy_uri, prm);
    } catch (Exception e) {
        call.delete();
        return;
    }

调用pjsua2JNI.Call_makeCall(swigCPtr, this, dst_uri, CallOpParam.getCPtr(prm), prm)

接受来电

来电将被报告为Account类的onIncomingCall（）。必须从Account类派生一个类来处理来电。

以下是回调实现的示例代码：

@Override
    public void onIncomingCall(OnIncomingCallParam prm) {
        System.out.println("======== Incoming call ======== ");
        MyCall call = new MyCall(this, prm.getCallId());
        MyApp.observer.notifyIncomingCall(call);
    }

所有呼叫属性，如状态，媒体状态，远端（远程对等体）信息等都存储为CallInfo类，可以使用Call的getInfo（）方法获取。

呼叫断开

呼叫断开事件是一个特殊的事件，因为一旦报告此事件的回调返回，该调用将不再有效，并且调用对象的任何操作将引发错误异常。因此，建议删除回调中的调用对象。

Call的onCallState（）方法报告呼叫断开，然后我们可以销毁此次通话Call：

@Override
    public void onCallState(OnCallStateParam prm) {
        MyApp.observer.notifyCallState(this);
        try {
            CallInfo ci = getInfo();
            if (ci.getState() ==
                    pjsip_inv_state.PJSIP_INV_STATE_DISCONNECTED) {
                this.delete();
            }
        } catch (Exception e) {
            return;
        }
    }

通话的音频媒体状态

当呼叫的音频媒体准备就绪（或激活）时，只能使用呼叫的音频媒体（例如，连接会议电话中的声音设备的呼叫）。呼叫媒体状态的更改在onCallMediaState（）回调中报告，如果呼叫音频媒体已准备就绪（或活动），则Call.getMedia（）函数将返回有效的音频媒体。

呼叫操作

可以调用Call对象的操作，例如挂断，保持呼叫，发送re-INVITE等。

即时消息（IM）

可以使用Call.sendInstantMessage（）在通话中发送IM。Call.onInstantMessageStatus（）回调方法报告传出即时消息的传输状态。

除了发送即时消息，还可以使用Call.sendTypingIndication（）发送打字指示。

在呼叫中收到的IM和打字指示将在回调函数Call.onInstantMessage（）和Call.onTypingIndication（）中报告。

关于上述详细类信息参考可以参照官方文档pjsip-book