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

To get started, you need to get an instance of the {@link android.net.sip.SipManager} by calling {@link android.net.sip.SipManager#newInstance newInstance()}.

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

Both {@link android.net.sip.SipManager#makeAudioCall makeAudioCall()} also requires two {@link android.net.sip.SipProfile} objects, representing the local device and the peer device. You can create a {@link android.net.sip.SipProfile} using the {@link android.net.sip.SipProfile.Builder} subclass.

Once you have a {@link android.net.sip.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 {@link android.net.sip.SipManager}, using {@link android.net.sip.SipManager#open open()}. If you only want to create audio SIP calls, though, you should use the {@link android.net.sip.SipAudioCall} class, as described above.

Note: Not all Android-powered devices support VOIP functionality with SIP. Before performing any SIP activity, you should call {@link android.net.sip.SipManager#isVoipSupported isVoipSupported()} to verify that the device supports VOIP calling and {@link android.net.sip.SipManager#isApiSupported isApiSupported()} to verify that the device supports the SIP APIs.

Your application must also request the {@link android.Manifest.permission#INTERNET} and {@link android.Manifest.permission#USE_SIP} permissions in order to use the SIP APIs.