Added in API level 9
Deprecated in API level 31

Listener

Kotlin |Java

open class Listener

kotlin.Any
↳	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
open Unit	`onCallBusy(call: SipAudioCall!)` Called when the peer is busy during session initialization.
open Unit	`onCallEnded(call: SipAudioCall!)` Called when the session is terminated.
open Unit	`onCallEstablished(call: SipAudioCall!)` Called when the session is established.
open Unit	`onCallHeld(call: SipAudioCall!)` Called when the call is on hold.
open Unit	`onCalling(call: SipAudioCall!)` Called when a request is sent out to initiate a new call.
open Unit	`onChanged(call: SipAudioCall!)` Called when an event occurs and the corresponding callback is not overridden.
open Unit	`onError(call: SipAudioCall!, errorCode: Int, errorMessage: String!)` Called when an error occurs.
open Unit	`onReadyToCall(call: SipAudioCall!)` Called when the call object is ready to make another call.
open Unit	`onRinging(call: SipAudioCall!, caller: SipProfile!)` Called when a new call comes in.
open Unit	`onRingingBack(call: SipAudioCall!)` Called when a RINGING response is received for the INVITE request sent.

Public constructors

Listener

Listener()

Public methods

onCallBusy

Added in API level 9

open fun onCallBusy(call: SipAudioCall!): Unit

Deprecated: Deprecated in Java.

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

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

onCallEnded

Added in API level 9

open fun onCallEnded(call: SipAudioCall!): Unit

Deprecated: Deprecated in Java.

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

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

onCallEstablished

Added in API level 9

open fun onCallEstablished(call: SipAudioCall!): Unit

Deprecated: Deprecated in Java.

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

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

onCallHeld

Added in API level 9

open fun onCallHeld(call: SipAudioCall!): Unit

Deprecated: Deprecated in Java.

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

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

onCalling

Added in API level 9

open fun onCalling(call: SipAudioCall!): Unit

Deprecated: Deprecated in Java.

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

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

onChanged

Added in API level 9

open fun onChanged(call: SipAudioCall!): Unit

Deprecated: Deprecated in Java.

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.

onError

Added in API level 9

open fun onError(
    call: SipAudioCall!, 
    errorCode: Int, 
    errorMessage: String!
): Unit

Deprecated: Deprecated in Java.

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

android.net.sip.SipErrorCode

onReadyToCall

Added in API level 9

open fun onReadyToCall(call: SipAudioCall!): Unit

Deprecated: Deprecated in Java.

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

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

onRinging

Added in API level 9

open fun onRinging(
    call: SipAudioCall!, 
    caller: SipProfile!
): Unit

Deprecated: Deprecated in Java.

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

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

open fun onRingingBack(call: SipAudioCall!): Unit

Deprecated: Deprecated in Java.

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

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