Sipdroid源码初探(二)：监听来电,通话建立流程
sip协议的相关背景知识
SIP协议是一个Client/Sever协议，因此SIP消息分两种：请求消息和响应消息。请求消息是SIP客户端为了激活特定操作而发给服务器端的消息。常用的SIP请求消息如下：
INVITE：表示主叫用户发起会话请求，邀请其他用户加入一个会话。也可以用在呼叫建立后用于更新会话（此时该INVITE又称为Re-invite）。
ACK：客户端向服务器端证实它已经收到了对INVITE请求的最终响应。
PRACK：表示对1xx响应消息的确认请求消息。
BYE：表示终止一个已经建立的呼叫。
CANCEL：表示在收到对请求的最终响应之前取消该请求，对于已完成的请求则无影响。
REGISTER：表示客户端向SIP服务器端注册列在To字段中的地址信息。
OPTIONS：表示查询被叫的相关信息和功能。SIP协议中的响应消息用于对请求消息进行响应，指示呼叫的成功或失败状态。
常用的一些响应消息：100试呼叫（Trying）
180振铃（Ringing）
181呼叫正在前转（Call is Being Forwarded）
200成功响应（OK）
302临时迁移（Moved Temporarily）
400错误请求（Bad Request）
401未授权（Unauthorized）
403禁止（Forbidden）
404用户不存在（Not Found）
408请求超时（Request Timeout）
480暂时无人接听（Temporarily Unavailable）
486线路忙（Busy Here）
504服务器超时（Server Time-out）
600全忙（Busy Everywhere）
以上背景知识在下面的代码分析中会用到。
开始
为了了解如何监听来电，我们从Sipdroid.StartEngine()开始，一步一步写出函数的调用过程。过程如下：
Sipdroid.StartEngine() -> Sipdroid.listen() -> UserAgent.listen() ->ExtendedCall.listen() -> ExtendedInviteDialog.listen() -> InviteTransactionServer.listen()
好戏从InviteTransactionServer.listen()开始，下面是代码：
public void listen() {
printLog("start", LogLevel.LOW);
if (statusIs(STATE_IDLE)) {
changeStatus(STATE_WAITING);
sip_provider.addSipProviderListener(new TransactionIdentifier(
SipMethods.INVITE), this);
sip_provider.addSipProviderListener(new TransactionIdentifier(
SipMethods.OPTIONS), this);
}
}大概得看上去，这里是给sip_provider添加了几个Listener，参数中寻找回调接口时发现了this,那就是在本类中了。寻找后发现回调方法就是这个了：
public void onReceivedMessage(SipProvider provider, Message msg) {
if (msg.isRequest()) {
String req_method = msg.getRequestLine().getMethod();
// invite 消息收到
if (req_method.equals(SipMethods.INVITE)) {
if (statusIs(STATE_WAITING)) {
request = new Message(msg);
connection_id = request.getConnectionId();
transaction_id = request.getTransactionId();
sip_provider.addSipProviderListener(transaction_id, this);
sip_provider
.removeSipProviderListener(new TransactionIdentifier(
SipMethods.INVITE));
changeStatus(STATE_TRYING);
// automatically send "100 Tryng" response and go to
// STATE_PROCEEDING
//自动回复"100 Tryng"消息
if (auto_trying) {
Message trying100 = MessageFactory.createResponse(
request, 100, SipResponses.reasonOf(100), null);
respondWith(trying100); // this method makes it going
// automatically to
// STATE_PROCEEDING
}
if (transaction_listener != null)
transaction_listener.onTransRequest(this, msg);
return;
}
if (statusIs(STATE_PROCEEDING) || statusIs(STATE_COMPLETED)) { // retransmission
// of
// the
// last
// response
sip_provider.sendMessage(response, connection_id);
return;
}
}
//如果收到的是 OPTIONS 消息
if (req_method.equals(SipMethods.OPTIONS)) {
Message ok200 = MessageFactory.createResponse(msg, 200, SipResponses.reasonOf(200), null);
ok200.removeServerHeader();
ok200.addContactHeader(new ContactHeader(ok200.getToHeader().getNameAddress()), false);
sip_provider.sendMessage(ok200, connection_id);
return;
}
// ack received
//如果收到的是 ack 消息
if (req_method.equals(SipMethods.ACK) && statusIs(STATE_COMPLETED)) {
retransmission_to.halt();
end_to.halt();
changeStatus(STATE_CONFIRMED);
if (transaction_listener != null)
transaction_listener.onTransFailureAck(this, msg);
clearing_to.start();
return;
}
}
}初看此方法，可以发现这里面的处理分为三种情况，收到 invite 消息时，收到options 消息时，收到 ack 消息时。本类的名字是InviteTransactionServer，意思是invite消息服务器，就是说这个类是专门用来处理invite消息的，对于其他的消息的处理就在其他的专门的类中了。
结合本文开篇的背景知识，我们就能知道这里实际上就是在对sip协议中的其中三种请求进行处理。根据sip协议，当一个用户想要拨打另一用户，代理服务器会首先将invite消息发给另一用户。在此方法中，我们只看见了对于invite消息进行回复100，根据sip协议，通话的建立是需要两个客户端进行几次握手的，这里仅仅是回复了一次消息，距离通话建立还有几步，不过这里好像就没有看到后续的操作了。
sipdroid的源码分层十分明显，从底层的网络数据接受发送到上层的呼叫的各种状态的建立（来电，接通，取消，挂断等等），每一层都用了单独的类。这里简单记录一下个类的分层情况（这里是仅考虑等待来电到接通电话，其他的代码还没看），从上往下是：
UserAgent(直接处理来电)
ExtendedCall （extends Call）
ExtendedInviteDialog （extends InviteDialog）
InviteTransactionServer
每一层通过回调接口相互联系。具体的流程十分的繁杂，文字叙述还真是很不方便。