# Print output for @column tags ?>
Developers

- Design
- Develop
- Distribute

Developer Console

## Most visited

## Recently visited

## Results for

Summary: Ctors | Methods | Inherited Methods

# SipSession.Listener

`public static class SipSession.Listener`
`extends Object` ``

java.lang.Object
↳ | android.net.sip.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").

Many of these events are also received by `SipAudioCall.Listener`.

## Summary

### Public constructors
`Listener()`

### Public methods
`void` | `onCallBusy(SipSession session)` Called when the peer is busy during session initialization.
`void` | `onCallChangeFailed(SipSession session, int errorCode, String errorMessage)` Called when an error occurs during session modification negotiation.
`void` | `onCallEnded(SipSession session)` Called when the session is terminated.
`void` | `onCallEstablished(SipSession session, String sessionDescription)` Called when the session is established.
`void` | `onCalling(SipSession session)` Called when an INVITE request is sent to initiate a new call.
`void` | `onError(SipSession session, int errorCode, String errorMessage)` Called when an error occurs during session initialization and termination.
`void` | `onRegistering(SipSession session)` Called when a registration request is sent.
`void` | `onRegistrationDone(SipSession session, int duration)` Called when registration is successfully done.
`void` | `onRegistrationFailed(SipSession session, int errorCode, String errorMessage)` Called when the registration fails.
`void` | `onRegistrationTimeout(SipSession session)` Called when the registration gets timed out.
`void` | `onRinging(SipSession session, SipProfile caller, String sessionDescription)` Called when an INVITE request is received.
`void` | `onRingingBack(SipSession session)` Called when a RINGING response is received for the INVITE request sent

### Inherited methods
From class `java.lang.Object`
`Object` | `clone()` Creates and returns a copy of this object.
`boolean` | `equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void` | `finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>` | `getClass()` Returns the runtime class of this `Object`.
`int` | `hashCode()` Returns a hash code value for the object.
`final void` | `notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void` | `notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String` | `toString()` Returns a string representation of the object.
`final void` | `wait(long timeout, int nanos)` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
`final void` | `wait(long timeout)` Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.
`final void` | `wait()` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.

## Public constructors

### Listener

    public Listener ()

## Public methods

### onCallBusy

    public void onCallBusy (SipSession session)

Called when the peer is busy during session initialization.

Parameters
`session` | `SipSession`: the session object that carries out the transaction

### onCallChangeFailed

    public void onCallChangeFailed (SipSession session,
                    int errorCode,
                    String errorMessage)

Called when an error occurs during session modification negotiation.

Parameters
`session` | `SipSession`: the session object that carries out the transaction
`errorCode` | `int`: error code defined in `SipErrorCode`
`errorMessage` | `String`: error message

### onCallEnded

    public void onCallEnded (SipSession session)

Called when the session is terminated.

Parameters
`session` | `SipSession`: the session object that is associated with the dialog

### onCallEstablished

    public void onCallEstablished (SipSession session,
                    String sessionDescription)

Called when the session is established.

Parameters
`session` | `SipSession`: the session object that is associated with the dialog
`sessionDescription` | `String`: the peer's session description

### onCalling

    public void onCalling (SipSession session)

Called when an INVITE request is sent to initiate a new call.

Parameters
`session` | `SipSession`: the session object that carries out the transaction

### onError

    public void onError (SipSession session,
                    int errorCode,
                    String errorMessage)

Called when an error occurs during session initialization and termination.

Parameters
`session` | `SipSession`: the session object that carries out the transaction
`errorCode` | `int`: error code defined in `SipErrorCode`
`errorMessage` | `String`: error message

### onRegistering

    public void onRegistering (SipSession session)

Called when a registration request is sent.

Parameters
`session` | `SipSession`: the session object that carries out the transaction

### onRegistrationDone

    public void onRegistrationDone (SipSession session,
                    int duration)

Called when registration is successfully done.

Parameters
`session` | `SipSession`: the session object that carries out the transaction
`duration` | `int`: duration in second before the registration expires

### onRegistrationFailed

    public void onRegistrationFailed (SipSession session,
                    int errorCode,
                    String errorMessage)

Called when the registration fails.

Parameters
`session` | `SipSession`: the session object that carries out the transaction
`errorCode` | `int`: error code defined in `SipErrorCode`
`errorMessage` | `String`: error message

### onRegistrationTimeout

    public void onRegistrationTimeout (SipSession session)

Called when the registration gets timed out.

Parameters
`session` | `SipSession`: the session object that carries out the transaction

### onRinging

    public void onRinging (SipSession session,
                    SipProfile caller,
                    String sessionDescription)

Called when an INVITE request is received.

Parameters
`session` | `SipSession`: the session object that carries out the transaction
`caller` | `SipProfile`: the SIP profile of the caller
`sessionDescription` | `String`: the caller's session description

### onRingingBack

    public void onRingingBack (SipSession session)

Called when a RINGING response is received for the INVITE request sent

Parameters
`session` | `SipSession`: the session object that carries out the transaction

Full name *
Email address *
Company / developer name
One of your Play Store app URLs *
Which best describes your business:*
Apps
Games
Apps & Games
*
*