Android - SIP Protocol
SIP stands for (Session Initiation Protocol). It is a protocol that let applications easily set up outgoing and incoming voice calls, without having to manage sessions, transport-level communication, or audio record or playback directly.
Applications
Some of the common applications of SIP are.
- Video conferencing
- Instant messaging
Requirements
Here are the requirements for developing a SIP application −
- Android OS must be 2.3 or higher
- You must have a data connection or WIFI
- You must have an SIP account in order to use this service.
SIP Classes
Here is a summary of the classes that are included in the Android SIP API:
| Sr.No |
Class & description |
| 1 |
SipAudioCall
Handles an Internet audio call over SIP |
| 2 |
SipErrorCode
Defines error codes returned during SIP actions |
| 3 |
SipManager
Provides APIs for SIP tasks, such as initiating SIP connections, and provides access to related SIP services |
| 4 |
SipProfile
Defines a SIP profile, including a SIP account, domain and server information |
| 5 |
SipSession
Represents a SIP session that is associated with a SIP dialog or a standalone transaction not within a dialog |
Functions of SIP
SIP has following major functions.
- SIP allows for the establishment of user location
- SIP provides a mechanism for call management
- SIP provides feature negotiation, so that all the parties in the call can agree to the features supported among them
Components of SIP
SIP has two major components which are listed below.
- User Agent Client (UAC)
- User Agent Server (UAS)
UAC
UAC or User Agent Client are those end users who generates requests and send those requests to the server.These requests are generated by the client applications running on their systems.
UAS
UAS or User Agent Server are those systems which get the request generated by UAC. The UAS process those requests and then according to the requests it generates responses accordingly.
SipManager
SipManager is an android API for SIP tasks, such as initiating SIP connections, and provides access to related SIP services. This class is the starting point for any SIP actions. You can acquire an instance of it with newInstance().
The SipManager has many functions for managing SIP tasks. Some of the functions are listed below.
| Sr.No |
Class & description |
| 1 |
close(String localProfileUri)
Closes the specified profile to not make/receive calls |
| 2 |
getCallId(Intent incomingCallIntent)
Gets the call ID from the specified incoming call broadcast intent |
| 3 |
isOpened(String localProfileUri)
Checks if the specified profile is opened in the SIP service for making and/or receiving calls |
| 4 |
isSipWifiOnly(Context context)
Returns true if SIP is only available on WIFI |
| 5 |
isRegistered(String localProfileUri)
Checks if the SIP service has successfully registered the profile to the SIP provider (specified in the profile) for receiving calls |
| 6 |
isVoipSupported(Context context)
Returns true if the system supports SIP-based VOIP API |
| 7 |
takeAudioCall(Intent incomingCallIntent, SipAudioCall.Listener listener)
Creates a SipAudioCall to take an incoming call |
| 8 |
unregister(SipProfile localProfile, SipRegistrationListener listener) Manually unregisters the profile from the corresponding SIP provider for stop receiving further calls |
