CoreListener class

public interface CoreListener

That class holds all the callbacks which are called by LinphoneCore.

Use linphone_factory_create_core_cbs to create an instance. Then, call the callback setters on the events you need to monitor and pass the object to a LinphoneCore instance through linphone_core_add_callbacks.

That class is inherited from belle_sip_object_t.

C C++ Java C#

Summary

Methods

onTransferStateChanged()

Callback for notifying progresses of transfers.

onFriendListCreated()

Callback prototype for reporting when a friend list has been added to the core friends list.

onSubscriptionStateChanged()

Callback prototype for notifying the application about changes of subscription states, including arrival of new subscriptions.

onCallLogUpdated()

Callback to notify a new call-log entry has been added.

onCallStateChanged()

Call state notification callback.

onAuthenticationRequested()

Callback for requesting authentication information to application or user.

onNotifyPresenceReceivedForUriOrTel()

Reports presence model change for a specific URI or phone number of a friend.

onChatRoomStateChanged()

Callback prototype telling that a LinphoneChatRoom state has changed.

onBuddyInfoUpdated()

Callback prototype.

onNetworkReachable()

Callback prototype for reporting network change either automatically detected or notified by linphone_core_set_network_reachable.

onNotifyReceived()

Callback prototype for notifying the application about notification received from the network.

onNewSubscriptionRequested()

Reports that a new subscription request has been received and wait for a decision.

onCallStatsUpdated()

Callback for receiving quality statistics for calls.

onNotifyPresenceReceived()

Report status change for a friend previously added to LinphoneCore.

onEcCalibrationAudioInit()

Function prototype used by #linphone_core_cbs_set_ec_calibrator_audio_init().

onMessageReceived()

Chat message callback prototype.

onEcCalibrationResult()

Function prototype used by #linphone_core_cbs_set_ec_calibrator_result().

onSubscribeReceived()

Callback prototype for notifying the application about subscription received from the network.

onInfoReceived()

Callback prototype for receiving info messages.

onChatRoomRead()

Chat room marked as read callback.

onRegistrationStateChanged()

Registration state notification callback prototype.

onFriendListRemoved()

Callback prototype for reporting when a friend list has been removed from the core friends list.

onReferReceived()

Callback prototype.

onQrcodeFound()

Callback prototype telling the result of decoded qrcode.

onConfiguringStatus()

Callback prototype for configuring status changes notification.

onCallCreated()

Callback notifying that a new LinphoneCall (either incoming or outgoing) has been created.

onPublishStateChanged()

Callback prototype for notifying the application about changes of publish states.

onCallEncryptionChanged()

Call encryption changed callback.

onIsComposingReceived()

Is composing notification callback prototype.

onMessageReceivedUnableDecrypt()

Chat message not decrypted callback prototype.

onLogCollectionUploadProgressIndication()

Callback prototype for reporting log collection upload progress indication.

onVersionUpdateCheckResultReceived()

Callback prototype for reporting the result of a version update check.

onEcCalibrationAudioUninit()

Function prototype used by #linphone_core_cbs_set_ec_calibrator_audio_uninit().

onGlobalStateChanged()

Global state notification callback.

onLogCollectionUploadStateChanged()

Callback prototype for reporting log collection upload state change.

onDtmfReceived()

Callback for being notified of DTMFs received.

onMessageSent()

Chat message callback prototype.

Detailed descriptions

Public methods

public void onTransferStateChanged(linphone.Core lc, linphone.Call transfered, linphone.Call.State newCallState)

Callback for notifying progresses of transfers.

Parameters
  • lc – the LinphoneCore

  • transfered – the call that was transfered

  • newCallState – the state of the call to transfer target at the far end.

C C++ Java C#

public void onFriendListCreated(linphone.Core lc, linphone.FriendList list)

Callback prototype for reporting when a friend list has been added to the core friends list.

Parameters
  • lc – LinphoneCore object

  • list – LinphoneFriendList object

C C++ Java C#

public void onSubscriptionStateChanged(linphone.Core lc, linphone.Event lev, linphone.SubscriptionState state)

Callback prototype for notifying the application about changes of subscription states, including arrival of new subscriptions.

C C++ Java C#

public void onCallLogUpdated(linphone.Core lc, linphone.CallLog newcl)

Callback to notify a new call-log entry has been added.

This is done typically when a call terminates.

Parameters
  • lc – the LinphoneCore

  • newcl – the new call log entry added.

C C++ Java C#

public void onCallStateChanged(linphone.Core lc, linphone.Call call, linphone.Call.State cstate, String message)

Call state notification callback.

Parameters
  • lc – the LinphoneCore

  • call – the call object whose state is changed.

  • cstate – the new state of the call

  • message – a non null informational message about the state.

C C++ Java C#

public void onAuthenticationRequested(linphone.Core lc, linphone.AuthInfo authInfo, linphone.AuthMethod method)

Callback for requesting authentication information to application or user.

Parameters
  • lc – the LinphoneCore

  • authInfo – a LinphoneAuthInfo pre-filled with username, realm and domain values as much as possible

  • method – the type of authentication requested Application shall reply to this callback using linphone_core_add_auth_info.

C C++ Java C#

public void onNotifyPresenceReceivedForUriOrTel(linphone.Core lc, linphone.Friend lf, String uriOrTel, linphone.PresenceModel presenceModel)

Reports presence model change for a specific URI or phone number of a friend.

Parameters
  • lc – LinphoneCore object

  • lf – LinphoneFriend object

  • uriOrTel – The URI or phone number for which teh presence model has changed

  • presenceModel – The new presence model

C C++ Java C#

public void onChatRoomStateChanged(linphone.Core lc, linphone.ChatRoom cr, linphone.ChatRoom.State state)

Callback prototype telling that a LinphoneChatRoom state has changed.

Parameters
  • lc – LinphoneCore object

  • cr – The LinphoneChatRoom object for which the state has changed

C C++ Java C#

public void onBuddyInfoUpdated(linphone.Core lc, linphone.Friend lf)

Callback prototype.

C C++ Java C#

public void onNetworkReachable(linphone.Core lc, boolean reachable)

Callback prototype for reporting network change either automatically detected or notified by linphone_core_set_network_reachable.

Parameters
  • lc – the LinphoneCore

  • reachable – true if network is reachable.

C C++ Java C#

public void onNotifyReceived(linphone.Core lc, linphone.Event lev, String notifiedEvent, linphone.Content body)

Callback prototype for notifying the application about notification received from the network.

C C++ Java C#

public void onNewSubscriptionRequested(linphone.Core lc, linphone.Friend lf, String url)

Reports that a new subscription request has been received and wait for a decision.

Status on this subscription request is notified by changing policy for this friend

Parameters
  • lc – LinphoneCore object

  • lf – LinphoneFriend corresponding to the subscriber

  • url – of the subscriber

C C++ Java C#

public void onCallStatsUpdated(linphone.Core lc, linphone.Call call, linphone.CallStats stats)

Callback for receiving quality statistics for calls.

Parameters
  • lc – the LinphoneCore

  • call – the call

  • stats – the call statistics.

C C++ Java C#

public void onNotifyPresenceReceived(linphone.Core lc, linphone.Friend lf)

Report status change for a friend previously added to LinphoneCore.

Parameters
  • lc – LinphoneCore object .

  • lf – Updated LinphoneFriend .

C C++ Java C#

public void onEcCalibrationAudioInit(linphone.Core lc)

Function prototype used by #linphone_core_cbs_set_ec_calibrator_audio_init().

Parameters
  • lc – The core.

C C++ Java C#

public void onMessageReceived(linphone.Core lc, linphone.ChatRoom room, linphone.ChatMessage message)

Chat message callback prototype.

Parameters
  • lc – LinphoneCore object

  • room – LinphoneChatRoom involved in this conversation. Can be be created by the framework in case the from is not present in any chat room.

C C++ Java C#

public void onEcCalibrationResult(linphone.Core lc, linphone.EcCalibratorStatus status, int delayMs)

Function prototype used by #linphone_core_cbs_set_ec_calibrator_result().

Parameters
  • lc – The core.

  • status – The state of the calibrator.

  • delayMs – The measured delay if available.

C C++ Java C#

public void onSubscribeReceived(linphone.Core lc, linphone.Event lev, String subscribeEvent, linphone.Content body)

Callback prototype for notifying the application about subscription received from the network.

C C++ Java C#

public void onInfoReceived(linphone.Core lc, linphone.Call call, linphone.InfoMessage msg)

Callback prototype for receiving info messages.

Parameters
  • lc – the LinphoneCore

  • call – the call whose info message belongs to.

  • msg – the info message.

C C++ Java C#

public void onChatRoomRead(linphone.Core lc, linphone.ChatRoom room)

Chat room marked as read callback.

Parameters
  • lc – LinphoneCore object

  • room – LinphoneChatRoom that has been marked as read.

C C++ Java C#

public void onRegistrationStateChanged(linphone.Core lc, linphone.ProxyConfig cfg, linphone.RegistrationState cstate, String message)

Registration state notification callback prototype.

C C++ Java C#

public void onFriendListRemoved(linphone.Core lc, linphone.FriendList list)

Callback prototype for reporting when a friend list has been removed from the core friends list.

Parameters
  • lc – LinphoneCore object

  • list – LinphoneFriendList object

C C++ Java C#

public void onReferReceived(linphone.Core lc, String referTo)

Callback prototype.

C C++ Java C#

public void onQrcodeFound(linphone.Core lc, String result)

Callback prototype telling the result of decoded qrcode.

Parameters
  • lc – LinphoneCore object

  • result – The result of the decoded qrcode

C C++ Java C#

public void onConfiguringStatus(linphone.Core lc, linphone.ConfiguringState status, String message)

Callback prototype for configuring status changes notification.

Parameters
  • lc – the LinphoneCore

  • message – informational message.

C C++ Java C#

public void onCallCreated(linphone.Core lc, linphone.Call call)

Callback notifying that a new LinphoneCall (either incoming or outgoing) has been created.

Parameters
  • lc – LinphoneCore object that has created the call

  • call – The newly created LinphoneCall object

C C++ Java C#

public void onPublishStateChanged(linphone.Core lc, linphone.Event lev, linphone.PublishState state)

Callback prototype for notifying the application about changes of publish states.

C C++ Java C#

public void onCallEncryptionChanged(linphone.Core lc, linphone.Call call, boolean on, String authenticationToken)

Call encryption changed callback.

Parameters
  • lc – the LinphoneCore

  • call – the call on which encryption is changed.

  • on – whether encryption is activated.

  • authenticationToken – an authentication_token, currently set for ZRTP kind of encryption only.

C C++ Java C#

public void onIsComposingReceived(linphone.Core lc, linphone.ChatRoom room)

Is composing notification callback prototype.

Parameters
  • lc – LinphoneCore object

  • room – LinphoneChatRoom involved in the conversation.

C C++ Java C#

public void onMessageReceivedUnableDecrypt(linphone.Core lc, linphone.ChatRoom room, linphone.ChatMessage message)

Chat message not decrypted callback prototype.

Parameters
  • lc – LinphoneCore object

  • room – LinphoneChatRoom involved in this conversation. Can be be created by the framework in case the from is not present in any chat room.

C C++ Java C#

public void onLogCollectionUploadProgressIndication(linphone.Core lc, int offset, int total)

Callback prototype for reporting log collection upload progress indication.

Parameters
  • lc – LinphoneCore object

C C++ Java C#

public void onVersionUpdateCheckResultReceived(linphone.Core lc, linphone.VersionUpdateCheckResult result, String version, String url)

Callback prototype for reporting the result of a version update check.

Parameters
  • lc – LinphoneCore object

  • result – The result of the version update check

  • url – The url where to download the new version if the result is #LinphoneVersionUpdateCheckNewVersionAvailable

C C++ Java C#

public void onEcCalibrationAudioUninit(linphone.Core lc)

Function prototype used by #linphone_core_cbs_set_ec_calibrator_audio_uninit().

Parameters
  • lc – The core.

C C++ Java C#

public void onGlobalStateChanged(linphone.Core lc, linphone.GlobalState gstate, String message)

Global state notification callback.

Parameters
  • lc – the LinphoneCore.

  • gstate – the global state

  • message – informational message.

C C++ Java C#

public void onLogCollectionUploadStateChanged(linphone.Core lc, linphone.Core.LogCollectionUploadState state, String info)

Callback prototype for reporting log collection upload state change.

Parameters
  • lc – LinphoneCore object

  • state – The state of the log collection upload

  • info – Additional information: error message in case of error state, URL of uploaded file in case of success.

C C++ Java C#

public void onDtmfReceived(linphone.Core lc, linphone.Call call, int dtmf)

Callback for being notified of DTMFs received.

Parameters
  • lc – the linphone core

  • call – the call that received the dtmf

  • dtmf – the ascii code of the dtmf

C C++ Java C#

public void onMessageSent(linphone.Core lc, linphone.ChatRoom room, linphone.ChatMessage message)

Chat message callback prototype.

Parameters
  • lc – LinphoneCore object

  • room – LinphoneChatRoom involved in this conversation. Can be be created by the framework in case the from is not present in any chat room.

C C++ Java C#