CSipSimple程序之拨打电话

         与前面的短信发送一样，这里我们不再重复讲解ViewPage和Fragments以及进程间通信的内容，具体可参考前面的短信发送部分的内容。

         在这一部分，主要说明程序是如何从上层到调用本地的JNI库，实现SIP打电话功能的。这里我们主要以用户输入被打用户的SPI URI，即如图点击右下角的txt按钮，然后输入被打用户的URI(如wxm@10.7.106.74)，然后点击键盘按钮去往即进入打电话功能。如图26所示：



图26 被打用户的SPI URI
         接下来从点击键盘的“去往”按钮开始，分析程序是如何一步步调用底层JNI库的。首先如图27，有个键盘监听器，当键盘监听器监听到按下的action为EditorInfo.IME_ACTION_GO，即为去往按钮时，调用placeCall函数。

private OnEditorActionListener keyboardActionListener = new OnEditorActionListener() {
@Override
public boolean onEditorAction(TextView tv, int action, KeyEvent arg2) {
if (action == EditorInfo.IME_ACTION_GO) {
//IME_ACTION_GO即键盘上的Go按钮，
System.out.println("IME_ACTION_GO");
placeCall();
return true;
}
return false;
}
};

图27 键盘监听事件触发
         进入placeCall函数之后，如判断为SIP用户，则进行SipService方法调用，否则直接进行基本用户拨打。如图28程序所示：

private void placeCallWithOption(Bundle b) {
if (service == null) {
return;
}
String toCall = "";
Long accountToUse = SipProfile.INVALID_ID;
// Find account to use
SipProfile acc = accountChooserButton.getSelectedAccount();
if (acc != null) {
accountToUse = acc.id;
}
// Find number to dial
if(isDigit) {
toCall = PhoneNumberUtils.stripSeparators(digits.getText().toString());
}else {
toCall = digits.getText().toString();
}

if (TextUtils.isEmpty(toCall)) {
return;
}

// Well we have now the fields, clear theses fields
digits.getText().clear();

// -- MAKE THE CALL --//
if (accountToUse >= 0) {
// It is a SIP account, try to call service for that
System.out.println("to check that if it's a SIP account");
try {
//用的是SIP用户，所以调用该函数
service.makeCallWithOptions(toCall, accountToUse.intValue(), b);
} catch (RemoteException e) {
Log.e(THIS_FILE, "Service can't be called to make the call");
}
} else if (accountToUse != SipProfile.INVALID_ID) {
// It's an external account, find correct external account
//即用的是SIP电话还是基本电话
System.out.println("to check that if it's a external account");
CallHandlerPlugin ch = new CallHandlerPlugin(getActivity());
ch.loadFrom(accountToUse, toCall, new OnLoadListener() {
@Override
public void onLoad(CallHandlerPlugin ch) {
placePluginCall(ch);
}
});
}
}

图28 DialFragment程序
         上面的语句是进入if语句还是else if与下图29的选择有关。当点击红色矩形的按钮之后会弹出蓝色矩形内的图标，选择第一个表示用SIP账号拨打电话，选择第二个则表示用基本电话拨打。



图29 选择SIP账号还是基本电话账号
                  这里只说明使用SIP电话拨打情况。从图28可看出，程序调用了SipService的makeCallWithOptions方法。进而进入SipService的makeCallWithOptions方法。如图30所示：

@Override
public void makeCallWithOptions(final String callee, final int accountId, final Bundle options)
throws RemoteException {
SipService.this.enforceCallingOrSelfPermission(SipManager.PERMISSION_USE_SIP, null);
//We have to ensure service is properly started and not just binded
SipService.this.startService(new Intent(SipService.this, SipService.class));

if(pjService == null) {
System.out.println("In makeCallWithOptions(),the PjSipService is not started");
Log.e(THIS_FILE, "Can't place call if service not started");
// TODO - we should return a failing status here
return;
}

if(!supportMultipleCalls) {
// Check if there is no ongoing calls if so drop this request by alerting user
SipCallSession activeCall = pjService.getActiveCallInProgress();
if(activeCall != null) {
if(!CustomDistribution.forceNoMultipleCalls()) {
notifyUserOfMessage(R.string.not_configured_multiple_calls);
}
return;
}
}
getExecutor().execute(new SipRunnable() {
@Override
protected void doRun() throws SameThreadException {
//打电话
pjService.makeCall(callee, accountId, options);
}
});
}

图30 SipService的打电话方法
         这样，最终调用PJsipService的makeCall。如图31，红色字体即为最终调用了底层的JNI库函数。

/**
* Make a call
*
* @param callee remote contact ot call If not well formated we try to add
*            domain name of the default account
*/
public int makeCall(String callee, int accountId, Bundle b) throws SameThreadException {
if (!created) {
return -1;
}
//Transform a string callee into a valid sip uri in the context of an account
final ToCall toCall = sanitizeSipUri(callee, accountId);
if (toCall != null) {
pj_str_t uri = pjsua.pj_str_copy(toCall.getCallee());

// Nothing to do with this values
byte[] userData = new byte[1];
int[] callId = new int[1];
pjsua_call_setting cs = new pjsua_call_setting();
pjsua_msg_data msgData = new pjsua_msg_data();
int pjsuaAccId = toCall.getPjsipAccountId();

// Call settings to add video
pjsua.call_setting_default(cs);
cs.setAud_cnt(1);
cs.setVid_cnt(0);
if(b != null && b.getBoolean(SipCallSession.OPT_CALL_VIDEO, false)) {
cs.setVid_cnt(1);
}
cs.setFlag(0);
// Msg data to add headers
pjsua.msg_data_init(msgData);
pjsua.csipsimple_init_acc_msg_data(pjsuaAccId, msgData);

//判断是否打通
int status = pjsua.call_make_call(pjsuaAccId, uri, cs, userData, msgData, callId);
System.out.println("Get the call status -->" + status);
if(status == pjsuaConstants.PJ_SUCCESS) {
dtmfToAutoSend.put(callId[0], toCall.getDtmf());
Log.d(THIS_FILE, "DTMF - Store for " + callId[0] + " - "+toCall.getDtmf());
}
return status;
} else {
System.out.println("to call is null");
service.notifyUserOfMessage(service.getString(R.string.invalid_sip_uri) + " : "
+ callee);
}
return -1;
}

图31 PjSip的makeCall方法
         若使用电话视频也一样，从图31可看出，不管是否开启电话视频，只要使用PjSua设置的相关参数就可以了。如上面的解释语句：call settings to add video。其下面的那些语句就是设置加入vedio的。