to top
Android APIs
Added in API level 9
package

android.net.sip

Provides access to Session Initiation Protocol (SIP) functionality, such as making and answering VOIP calls using SIP.

For more information, see the Session Initiation Protocol developer guide.

To get started, you need to get an instance of the SipManager by calling newInstance().

With the SipManager, you can initiate SIP audio calls with makeAudioCall() and takeAudioCall(). Both methods require a SipAudioCall.Listener that receives callbacks when the state of the call changes, such as when the call is ringing, established, or ended.

Both makeAudioCall() also requires two SipProfile objects, representing the local device and the peer device. You can create a SipProfile using the SipProfile.Builder subclass.

Once you have a SipAudioCall, you can perform SIP audio call actions with the instance, such as make a call, answer a call, mute a call, turn on speaker mode, send DTMF tones, and more.

If you want to create generic SIP connections (such as for video calls or other), you can create a SIP connection from the SipManager, using open(). If you only want to create audio SIP calls, though, you should use the SipAudioCall class, as described above.

Note: Not all Android-powered devices support VOIP functionality with SIP. Before performing any SIP activity, you should call isVoipSupported() to verify that the device supports VOIP calling and isApiSupported() to verify that the device supports the SIP APIs. Your application must also request the INTERNET and USE_SIP permissions in order to use the SIP APIs.

Interfaces

SipRegistrationListener Listener for SIP registration events. 

Classes

SipAudioCall Handles an Internet audio call over SIP. 
SipAudioCall.Listener Listener for events relating to a SIP call, such as when a call is being recieved ("on ringing") or a call is outgoing ("on calling"). 
SipErrorCode Defines error codes returned during SIP actions. 
SipManager Provides APIs for SIP tasks, such as initiating SIP connections, and provides access to related SIP services. 
SipProfile Defines a SIP profile, including a SIP account, domain and server information. 
SipProfile.Builder Helper class for creating a SipProfile
SipSession Represents a SIP session that is associated with a SIP dialog or a standalone transaction not within a dialog. 
SipSession.Listener Listener for events relating to a SIP session, such as when a session is being registered ("on registering") or a call is outgoing ("on calling"). 
SipSession.State Defines SIP session states, such as "registering", "outgoing call", and "in call". 

Exceptions

SipException Indicates a general SIP-related exception.