Added in API level 9
Deprecated in API level 31

Summary: Ctors | Methods | Inherited Methods

SipAudioCall.Listener

Kotlin |Java

public static class SipAudioCall.Listener
extends Object

java.lang.Object
↳	android.net.sip.SipAudioCall.Listener

Listener for events relating to a SIP call, such as when a call is being received ("on ringing") or a call is outgoing ("on calling").

Many of these events are also received by SipSession.Listener.

Summary

Public constructors
`Listener()`

Public methods
`void`	`onCallBusy(SipAudioCall call)` Called when the peer is busy during session initialization.
`void`	`onCallEnded(SipAudioCall call)` Called when the session is terminated.
`void`	`onCallEstablished(SipAudioCall call)` Called when the session is established.
`void`	`onCallHeld(SipAudioCall call)` Called when the call is on hold.
`void`	`onCalling(SipAudioCall call)` Called when a request is sent out to initiate a new call.
`void`	`onChanged(SipAudioCall call)` Called when an event occurs and the corresponding callback is not overridden.
`void`	`onError(SipAudioCall call, int errorCode, String errorMessage)` Called when an error occurs.
`void`	`onReadyToCall(SipAudioCall call)` Called when the call object is ready to make another call.
`void`	`onRinging(SipAudioCall call, SipProfile caller)` Called when a new call comes in.
`void`	`onRingingBack(SipAudioCall call)` 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 timeoutMillis, int nanos)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait(long timeoutMillis)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait()` Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Public constructors

Listener

public Listener ()

Public methods

onCallBusy

Added in API level 9

public void onCallBusy (SipAudioCall call)

Called when the peer is busy during session initialization. The default implementation calls onChanged(SipAudioCall).

Parameters
`call`	`SipAudioCall`: the call object that carries out the audio call

onCallEnded

Added in API level 9

public void onCallEnded (SipAudioCall call)

Called when the session is terminated. The default implementation calls onChanged(SipAudioCall).

Parameters
`call`	`SipAudioCall`: the call object that carries out the audio call

onCallEstablished

Added in API level 9

public void onCallEstablished (SipAudioCall call)

Called when the session is established. The default implementation calls onChanged(SipAudioCall).

Parameters
`call`	`SipAudioCall`: the call object that carries out the audio call

onCallHeld

Added in API level 9

public void onCallHeld (SipAudioCall call)

Called when the call is on hold. The default implementation calls onChanged(SipAudioCall).

Parameters
`call`	`SipAudioCall`: the call object that carries out the audio call

onCalling

Added in API level 9

public void onCalling (SipAudioCall call)

Called when a request is sent out to initiate a new call. The default implementation calls onChanged(SipAudioCall).

Parameters
`call`	`SipAudioCall`: the call object that carries out the audio call

onChanged

Added in API level 9

public void onChanged (SipAudioCall call)

Called when an event occurs and the corresponding callback is not overridden. The default implementation is no op. Error events are not re-directed to this callback and are handled in onError(SipAudioCall, int, String).

Parameters
`call`	`SipAudioCall`

onError

Added in API level 9

public void onError (SipAudioCall call, 
                int errorCode, 
                String errorMessage)

Called when an error occurs. The default implementation is no op.

Parameters
`call`	`SipAudioCall`: the call object that carries out the audio call
`errorCode`	`int`: error code of this error
`errorMessage`	`String`: error message

See also:

SipErrorCode

onReadyToCall

Added in API level 9

public void onReadyToCall (SipAudioCall call)

Called when the call object is ready to make another call. The default implementation calls onChanged(SipAudioCall).

Parameters
`call`	`SipAudioCall`: the call object that is ready to make another call

onRinging

Added in API level 9

public void onRinging (SipAudioCall call, 
                SipProfile caller)

Called when a new call comes in. The default implementation calls onChanged(SipAudioCall).

Parameters
`call`	`SipAudioCall`: the call object that carries out the audio call
`caller`	`SipProfile`: the SIP profile of the caller

onRingingBack

Added in API level 9

public void onRingingBack (SipAudioCall call)

Called when a RINGING response is received for the INVITE request sent. The default implementation calls onChanged(SipAudioCall).

Parameters
`call`	`SipAudioCall`: the call object that carries out the audio call