Android Linphone source code tutorial - Part 2

I have published first part of Android Linphone SDK integration already. In this tutorial, I am going to share source code modification tips and overview of Linphone project code. Before reading this post, check Android Linphone SDK Tutorial - Part 1. Linphone project's packages and source code can be changed at any time but I am going to share details of Linphone project which I have currently.

Note:- Some PPTs are available on my slideshare account related to android linphone project.

.............................................................................................................

Basic overview of important packages is give below:-

1. org.linphone : This package has mostly all activities, fragments and important manager classes. Easily understandable by class name which class what will do.

2. org.linphone.compatibility : This package has compatibility classes for each android API level. To use notifications and gestures in different android versions.

3. org.linphone.gcm : This package has GCM service classes. Linphone uses SIP server for Push notifications to show chat, video call, etc. notification.

4. org.linphone.setup : This package has account setup classes. To register, login or manage user account.

5. org.linphone.ui : This package has user interface's widget classes. To manage action on widgets like call button, erase button, number button, on scrolling, on sliding drawer, etc.

.............................................................................................................

Now I am going to share some useful classes and codes:-

1. LinphoneCore : The LinphoneCore is the root for all liblinphone operations. You need only one per application.

LinphoneCore lc = LinphoneCoreFactory.instance().createLinphoneCore(listener, context)

Parameters:
listener(LinphoneCoreListener) - listener to receive notifications from the core.
context - an application context, on android this MUST be the android.content.Context object used by the application.

Throws: LinphoneCoreException

about listener class: create a class and implement LinphoneCoreListener and make an object "listener" and pass it.

you can also create it simply by using LinphoneManager in Linphone project:

LinphoneCore lc=LinphoneManager.getLc();

2. How to set/get register user details?

LinphonePreferences : This class uses setter and getter method for user info and every method is easily understandable.

LinphonePreferences mPrefs = LinphonePreferences.instance();

To get default user index:

int account_index=mPrefs.getDefaultAccountIndex();
String user_name=mPrefs.getAccountUsername(account_index);

now using default account index, we can set or get user details easily.

3. How to initiate/terminate/accept call on a sip address?

LinphoneManager.getInstance().newOutgoingCall(AddressType address);
//Or
LinphoneManager.getInstance().newOutgoingCall(String to, String displayName);

Address/to can be user_name or user_name@sip.linphone.org beacuse interpretUrl(String to) method converts string to LinphonAddress(SIP Address). InterpretUrl is a method of LinphoneCore class.

To terminate call, use:-

LinphoneManager.getInstance().terminateCall();

To check current call status(After State than write dot than press CTRL+SHIFT for all other options) in any class:-

lc.getCurrentCall().getState()==LinphoneCall.State.Connected

where lc is LinphoneCore object.

If you implement LinphoneCoreListener in any class(as LinphoneManager.java has) than the below method will call on every change in call status:-

public void callState(final LinphoneCore lc,final LinphoneCall call, final State state, final String message)
{
  //code here
}

To accept call:-

lc.acceptCall(aCall) // lc is LinphoneCore object & aCall is LinphoneCall object.

4. How to send/recieve chat message?

To send message, pass destination sip address as parameter:

LinphoneChatRoom chat_room = lc.createChatRoom("sip:joe@sip.linphone.org"); //lc is object of LinphoneCore
chat_room.sendMessage("Hello world");

To receive chat message, Implement LinphoneCoreListener in your class(as LinphoneManager.java
has) and textReceived method will call when you got message from someone.

void textReceived(LinphoneCore lc, LinphoneChatRoom cr,LinphoneAddress from,String message) {
//write code here to display message on gui.
}

5. How to add video call support in running audio call?

//Obtain reference of current call
LinphoneCall lCall = lc.getCurrentCall(); //lc is LinphoneCore object

//Obtain configuration parameter copy for current call
LinphoneCallParams params = lCall.getCurrentParamsCopy();

//Enable video
params.setVideoEnabled(true);

//Initiate reInvite
lc.updateCall(lCall, params);

For more download excel sheet of Linphone notes(Check all tabs of excel sheet) and check official document.

Related Programs:-

★ Start Working on Linphone Android

★ Add Google AdMob Ads in Android App & Earn Money

★ Add Facebook SDK in Android Application

★ Android Twitter Fabric SDK Integration with user details in Android Studio

★ Advance Android Google Map 2 Tutorial with Examples - Part 1