com.zoiper.zdk.EventHandlers

Interface AccountEventsHandler

public interface AccountEventsHandler

Method Summary

Modifier and Type	Method and Description
default void	onAccountCallOwnershipChanged(Account account, Call call, OwnershipChange action) Notify upon call ownership changed Providing information upon call ownership change.
default void	onAccountChatMessageReceived(Account account, java.lang.String pPeer, java.lang.String pContent) Notify upon Chat message was received Notify upon Chat message was received , provides the sender and the content of the message
default void	onAccountExtendedError(Account account, ExtendedError error) Notify upon account extended error occurs Event fired when extended error in account occurs, providing detailed information for the error in the ExtendedError object.
default void	onAccountIncomingCall(Account account, Call call) Notify upon Incoming Call Notification for incoming call
default void	onAccountRetryingRegistration(Account account, int isRetrying, int inSeconds) Notify upon Account is retrying registration Registration or unregistration is going to be retried automatically
default void	onAccountSipHeaderFields(Account account, java.util.List<HeaderField> headerFields) SIP header dump for a user registration Dumps the header of a SIP message from a SIP registration.
default void	onAccountStatusChanged(Account account, AccountStatus status, int statusCode) Notify upon Account status is changed Notify upon Account status is changed, provide which account and the status it is changed to.
default void	onAccountUserSipOutboundMissing(Account account) Warning for missing SIP Outbound support at the server Happens when there is a SIP account with SIP Outbound enabled but the server rejects the registrations with the error code 439, usually with the text "First Hop Lacks Outbound Support".
default void	onStunNetworkDiscovered(Account account, NetworkType networkType) Notify upon STUN discovered network type

Method Detail

onAccountStatusChanged

default void onAccountStatusChanged(Account account,
                                    AccountStatus status,
                                    int statusCode)

Notify upon Account status is changed Notify upon Account status is changed, provide which account and the status it is changed to.

Parameters:

account - The account which status is changed

status - What status the account is changed to

statusCode - The status representation as integer

See Also:

AccountStatus

onAccountRetryingRegistration

default void onAccountRetryingRegistration(Account account,
                                           int isRetrying,
                                           int inSeconds)

Notify upon Account is retrying registration Registration or unregistration is going to be retried automatically

Parameters:

account - Account object of the account which registration is retrying

isRetrying - Gives information if the event is register or unregister 1 = registering, 0 = unregistering

inSeconds - The (un)registration will be retried in this many seconds approximately (the event could have been in the queue for unknown period already)

See Also:

Account

onAccountIncomingCall

default void onAccountIncomingCall(Account account,
                                   Call call)

Notify upon Incoming Call Notification for incoming call

Parameters:

account - Account that receives the call

call - The call object holding handle to the incoming call

See Also:

Call

onAccountChatMessageReceived

default void onAccountChatMessageReceived(Account account,
                                          java.lang.String pPeer,
                                          java.lang.String pContent)

Notify upon Chat message was received Notify upon Chat message was received , provides the sender and the content of the message

Parameters:

account - Account that receives the message

pPeer - The message sender

pContent - Contents of the message

See Also:

Account

onAccountExtendedError

default void onAccountExtendedError(Account account,
                                    ExtendedError error)

Notify upon account extended error occurs Event fired when extended error in account occurs, providing detailed information for the error in the ExtendedError object.

Parameters:

account - Account that received the error

error - The error object that provides full information regarding the error

See Also:

ExtendedError

onAccountUserSipOutboundMissing

default void onAccountUserSipOutboundMissing(Account account)

Warning for missing SIP Outbound support at the server Happens when there is a SIP account with SIP Outbound enabled but the server rejects the registrations with the error code 439, usually with the text "First Hop Lacks Outbound Support". The full error information is passed in the registration error failure as usual. This event is pushed immediately after the registration failure event. The library will NOT alter its configuration automatically but if this behavior is desired the API user can just do the needed reconfiguration in this callback and issue a new registerUser request afterwards for immediate retry.

Parameters:

account - The user which got the registration error

See Also:

ExtendedError

onAccountCallOwnershipChanged

default void onAccountCallOwnershipChanged(Account account,
                                           Call call,
                                           OwnershipChange action)

Notify upon call ownership changed Providing information upon call ownership change. The OwnershipChange objects holds the information if the call is Relieved or Acquired.

Parameters:

account - Account whose call ownership is changed

call - The call which ownership is changed

action - The type of change that is happend (Relieve, Acquired or NA)

See Also:

Call OwnershipChange

onAccountSipHeaderFields

default void onAccountSipHeaderFields(Account account,
                                      java.util.List<HeaderField> headerFields)

SIP header dump for a user registration Dumps the header of a SIP message from a SIP registration. This is the header of the 200 response to the REGISTER request. Each header field from the SIP header is represented as an entry in @p headerFields. Each header field can have one or more values associated with it in the @p Values array. The header field @p Name and the @p Values are UTF-8 strings. The structure is valid only for the duration of this callback. To enable this callback, use sipConfig::HeaderDump.

Parameters:

account - The account which got the registration response

headerFields - The header fields array

See Also:

HeaderField

onStunNetworkDiscovered

default void onStunNetworkDiscovered(Account account,
                                     NetworkType networkType)

Notify upon STUN discovered network type

Parameters:

account - The account which status is changed

networkType - The discovered network type

See Also:

NetworkType