Class Core

Main object to instanciate and on which to keep a reference.

This object is the first object to instanciante, and will allow you to perform all kind of tasks. To create it, use either Linphone.Factory.CreateCore() or Linphone.Factory.CreateCoreWithConfig(), see Linphone.Config for more information about factory and default config. On some platforms like Android or iOS you will need to give it the Context of your application. Once the Linphone.Core is in state Linphone.GlobalState.Ready, use Linphone.Core.Start(). It will then go to state Linphone.GlobalState.On and from that you can start using it for calls and chat messages. It is recommended to add a Linphone.CoreListener listener using Linphone.Core.AddListener() to monitor different events. To be able to receive events from the network, you must schedule a call Linphone.Core.Iterate() often, like every 20ms. On Android & iOS Linphone.Core.IsAutoIterateEnabled() is enabled by default so you don't have to worry about that unless you disable it using Linphone.Core.EnableAutoIterate() or by setting in the [misc] section of your configuration auto_iterate=0.

Inheritance
System.Object
LinphoneObject
Core
Inherited Members
System.Object.ToString()
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.ReferenceEquals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
Namespace: Linphone
Assembly: cs.temp.dll.dll
Syntax
public class Core : LinphoneObject
Remarks

Warning : Our API isn't thread-safe but also isn't blocking, so it is strongly recommend to always call our methods from the main thread.

Properties

AccountCreatorBackend

Gets the Linphone.AccountCreator backend set for the Linphone.Core.

Declaration
public AccountCreatorBackend AccountCreatorBackend { get; set; }
Property Value
Type Description
AccountCreatorBackend

The Linphone.AccountCreatorBackend

AccountCreatorUrl

Gets the Linphone.AccountCreator url on the Linphone.Core.

Declaration
public string AccountCreatorUrl { get; set; }
Property Value
Type Description
System.String

url The URL to reach. @maybenil

AccountList

Returns an unmodifiable list of entered accounts.

Declaration
public IEnumerable<Account> AccountList { get; }
Property Value
Type Description
System.Collections.Generic.IEnumerable<Account>

@maybenil

AdaptiveRateAlgorithm

Returns which adaptive rate algorithm is currently configured for future calls.

Declaration
public string AdaptiveRateAlgorithm { get; set; }
Property Value
Type Description
System.String

the adaptive rate algorithm. Currently two values are supported: 'advanced', which is the default value, or 'basic'. @notnil
Remarks

See : Linphone.Core.AdaptiveRateAlgorithm

AdaptiveRateControlEnabled

Returns whether adaptive rate control is enabled.

Declaration
public bool AdaptiveRateControlEnabled { get; set; }
Property Value
Type Description
System.Boolean

true if adaptive rate control is enabled, false otherwise
Remarks

See : Linphone.Core.EnableAdaptiveRateControl()

AgcEnabled

Tells whether the experimental software Automatic Gain Control is activated.

This algorithm is very experimental, not usable in its current state.

Declaration
public bool AgcEnabled { get; set; }
Property Value
Type Description
System.Boolean

true if the AGC is enabled, false otherwise.

AlertsEnabled

Returns whether alert reporting is enabled.

See Linphone.Alert for more details.

Declaration
public bool AlertsEnabled { get; set; }
Property Value
Type Description
System.Boolean

whether alert reporting is enabled.

AudioAdaptiveJittcompEnabled

Tells whether the audio adaptive jitter compensation is enabled.

Declaration
public bool AudioAdaptiveJittcompEnabled { get; set; }
Property Value
Type Description
System.Boolean

true if the audio adaptive jitter compensation is enabled, false otherwise.

AudioDevices

Returns a list of audio devices, with only the first device for each type To have the list of all audio devices, use Linphone.Core.ExtendedAudioDevices

Declaration
public IEnumerable<AudioDevice> AudioDevices { get; }
Property Value
Type Description
System.Collections.Generic.IEnumerable<AudioDevice>

A list with the first Linphone.AudioDevice of each type @maybenil

AudioDscp

Gets the DSCP field for outgoing audio streams.

The DSCP defines the quality of service in IP packets.

Declaration
public int AudioDscp { get; set; }
Property Value
Type Description
System.Int32

The current DSCP value

AudioJittcomp

Returns the nominal audio jitter buffer size in milliseconds.

Declaration
public int AudioJittcomp { get; set; }
Property Value
Type Description
System.Int32

The nominal audio jitter buffer size in milliseconds

AudioMulticastAddr

Use to get multicast address to be used for audio stream.

Declaration
public string AudioMulticastAddr { get; set; }
Property Value
Type Description
System.String

an ipv4/6 multicast address or default value. @maybenil

AudioMulticastEnabled

Use to get multicast state of audio stream.

Declaration
public bool AudioMulticastEnabled { get; set; }
Property Value
Type Description
System.Boolean

true if subsequent calls will propose multicast ip set by Linphone.Core.AudioMulticastAddr

AudioMulticastTtl

Use to get multicast ttl to be used for audio stream.

Declaration
public int AudioMulticastTtl { get; set; }
Property Value
Type Description
System.Int32

a time to leave value

AudioPayloadTypes

Returns the list of the available audio payload types.

Declaration
public IEnumerable<PayloadType> AudioPayloadTypes { get; set; }
Property Value
Type Description
System.Collections.Generic.IEnumerable<PayloadType>

A freshly allocated list of the available payload types. @maybenil

AudioPort

Gets the UDP port used for audio streaming.

Declaration
public int AudioPort { get; set; }
Property Value
Type Description
System.Int32

The UDP port used for audio streaming

AudioPortsRange

Get the audio port range from which is randomly chosen the UDP port used for audio streaming.

Declaration
public Range AudioPortsRange { get; }
Property Value
Type Description
Range

a Linphone.Range object @notnil

AuthInfoList

Returns an unmodifiable list of currently entered Linphone.AuthInfo.

Declaration
public IEnumerable<AuthInfo> AuthInfoList { get; }
Property Value
Type Description
System.Collections.Generic.IEnumerable<AuthInfo>

A list of Linphone.AuthInfo. @maybenil

AutoDownloadIcalendarsEnabled

Gets if the automatic download of incoming icalendars is enabled or not.

Declaration
public bool AutoDownloadIcalendarsEnabled { get; set; }
Property Value
Type Description
System.Boolean

true if icalendars will be automatically downloaded, false otherwise.

AutoDownloadVoiceRecordingsEnabled

Gets if the auto download for incoming voice recordings is enabled or not.

Declaration
public bool AutoDownloadVoiceRecordingsEnabled { get; set; }
Property Value
Type Description
System.Boolean

true if voice recordings will be automatically downloaded, false otherwise.

AutoIterateBackgroundSchedule

Gets the timer used to schedule the call to core.iterate() method when in background (Android only).

This is only used when Linphone.Core.AutoIterateEnabled() returns true.

Declaration
public int AutoIterateBackgroundSchedule { get; set; }
Property Value
Type Description
System.Int32

The timing in milliseconds used to schedule the call while in background (default is 500ms).

AutoIterateEnabled

Gets whether auto iterate is enabled or not (Android & iOS only).

Declaration
public bool AutoIterateEnabled { get; set; }
Property Value
Type Description
System.Boolean

true if Linphone.Core.Iterate() is scheduled automatically, false otherwise

AutoIterateForegroundSchedule

Gets the timer used to schedule the call to core.iterate() method when in foreground (Android only).

This is only used when Linphone.Core.AutoIterateEnabled() returns true.

Declaration
public int AutoIterateForegroundSchedule { get; set; }
Property Value
Type Description
System.Int32

The timing in milliseconds used to schedule the call while in foreground (default is 20ms).

AutomaticHttpProxyDetectionEnabled

Returns whether automatic http proxy is enabled.

Declaration
public bool AutomaticHttpProxyDetectionEnabled { get; set; }
Property Value
Type Description
System.Boolean

true if automatic http proxy is enabled or false.

AutoSendRingingEnabled

Gets if the automatic sending of 180 Ringing is enabled or not.

Declaration
public bool AutoSendRingingEnabled { get; set; }
Property Value
Type Description
System.Boolean

true if the automatic sending of 180 Ringing is enabled, false otherwise.

AvpfMode

Returns AVPF enablement.

See Linphone.Core.AvpfMode .

Declaration
public AVPFMode AvpfMode { get; set; }
Property Value
Type Description
AVPFMode

The current Linphone.AVPFMode mode

AvpfRrInterval

Returns the avpf report interval in seconds.

Declaration
public int AvpfRrInterval { get; set; }
Property Value
Type Description
System.Int32

The current AVPF report interval in seconds

BaudotEnabled

Returns enablement of text sending via Baudot tones in the audio stream.

Declaration
public bool BaudotEnabled { get; set; }
Property Value
Type Description
System.Boolean

true if text sending via Baudot tones in the audio stream is enabled, false otherwise.

CallkitEnabled

Special function to check if the callkit is enabled, False by default.

Declaration
public bool CallkitEnabled { get; set; }
Property Value
Type Description
System.Boolean

true if callkit is enabled, false otherwise.

CallLogs

Get the list of call logs (past calls).

Declaration
public IEnumerable<CallLog> CallLogs { get; }
Property Value
Type Description
System.Collections.Generic.IEnumerable<CallLog>

A list of Linphone.CallLog. @maybenil

CallLogsDatabasePath

Gets the database filename where call logs will be stored.

Declaration
[Obsolete]
public string CallLogsDatabasePath { get; set; }
Property Value
Type Description
System.String

filesystem path. @maybenil
Remarks

Deprecated : 07/12/2021: Use only for migration purposes

CallOnHoldMusicFile

Get the wav file played when putting a call on hold with Linphone.Call.Pause()

The file is a 16 bit linear file.

Declaration
public string CallOnHoldMusicFile { get; set; }
Property Value
Type Description
System.String

The path to the file that is played when putting a call on hold. @maybenil

Calls

Gets the current list of calls.

Note that this list is read-only and might be changed by the core after a function call to Linphone.Core.Iterate(). Similarly the Linphone.Call objects inside it might be destroyed without prior notice. To hold references to Linphone.Call object into your program, you must use linphone_call_ref.

Declaration
public IEnumerable<Call> Calls { get; }
Property Value
Type Description
System.Collections.Generic.IEnumerable<Call>

A list of Linphone.Call @maybenil

CallsNb

Gets the number of Call.

Declaration
public int CallsNb { get; }
Property Value
Type Description
System.Int32

The current number of calls

CallToneIndicationsEnabled

Check whether tone indications of calls are enabled.

Declaration
public bool CallToneIndicationsEnabled { get; set; }
Property Value
Type Description
System.Boolean

true if call tone indications are enabled

CameraSensorRotation

Get the camera sensor rotation.

This is needed on some mobile platforms to get the number of degrees the camera sensor is rotated relative to the screen.

Declaration
public int CameraSensorRotation { get; }
Property Value
Type Description
System.Int32

The camera sensor rotation in degrees (0 to 360) or -1 if it could not be retrieved

CameraWhitebalance

Gets the whitebalance of the camera (currently only supported by Android).

Declaration
public int CameraWhitebalance { get; set; }
Property Value
Type Description
System.Int32

The whitebalance of the camera, default is -1 (disabled).

CapabilityNegociationEnabled

Checks if the capability negotiation (RFC5939) is supported or not.

Declaration
public bool CapabilityNegociationEnabled { get; set; }
Property Value
Type Description
System.Boolean

true if capability negotiation is supported; false otherwise.

CapabilityNegotiationReinviteEnabled

Checks if the capability negotiation (RFC5939) reINVITE is enabled or not.

Declaration
public bool CapabilityNegotiationReinviteEnabled { get; set; }
Property Value
Type Description
System.Boolean

true if capability negotiation reINVITE is enabled; false otherwise.

CaptureDevice

Gets the name of the currently assigned sound device for capture.

Declaration
[Obsolete]
public string CaptureDevice { get; set; }
Property Value
Type Description
System.String

The name of the currently assigned sound device for capture. @maybenil
Remarks

Deprecated : 11/09/2024 use Linphone.Core.InputAudioDevice or Linphone.Core.DefaultInputAudioDevice instead.

CfgLinesMergingEnabled

Checks if cfg lines are going to the merged if the capability negotiation (RFC5939) is supported or not.

Declaration
public bool CfgLinesMergingEnabled { get; set; }
Property Value
Type Description
System.Boolean

true if acfg and pcfg lines with consecutive indexes are going to be merged; false otherwise.

ChatEnabled

Returns whether chat is enabled.

Declaration
public bool ChatEnabled { get; }
Property Value
Type Description
System.Boolean

true if chat is enabled, false otherwise

ChatMessagesAggregationEnabled

End of group ldap.

Returns whether chat messages grouping is enabled or not.

Declaration
public bool ChatMessagesAggregationEnabled { get; set; }
Property Value
Type Description
System.Boolean

true if received chat messages will be notified as a bundle, false otherwise.

ChatRooms

Returns a list of chat rooms.

Declaration
public IEnumerable<ChatRoom> ChatRooms { get; }
Property Value
Type Description
System.Collections.Generic.IEnumerable<ChatRoom>

List of chat rooms. @maybenil

ConferenceAvailabilityBeforeStart

Gets the conference availability before start.

Declaration
public int ConferenceAvailabilityBeforeStart { get; set; }
Property Value
Type Description
System.Int32

the number of seconds the conference can be joined early
Remarks

Warning : This setting is only applicable to conference servers

ConferenceCleanupPeriod

Gets the conference cleanup timer period.

Declaration
public int ConferenceCleanupPeriod { get; set; }
Property Value
Type Description
System.Int32

the period of the conference cleanup timer

ConferenceExpirePeriod

Gets the conference expire period.

Declaration
public int ConferenceExpirePeriod { get; set; }
Property Value
Type Description
System.Int32

the number of second after which the conference cannot be joined
Remarks

Warning : This setting is only applicable to conference servers

ConferenceIcsInMessageBodyEnabled

Gets wether conference invitations will be sent in the chat message body or as a file attachment.

Declaration
public bool ConferenceIcsInMessageBodyEnabled { get; set; }
Property Value
Type Description
System.Boolean

true if ICS will be sent in the message body (by default), false if it will be sent as a file attachment.

ConferenceInformationList

Retrieve the list of conference information on DB.

Declaration
public IEnumerable<ConferenceInfo> ConferenceInformationList { get; }
Property Value
Type Description
System.Collections.Generic.IEnumerable<ConferenceInfo>

The list of conference infos . @maybenil

ConferenceLocalInputVolume

Returns the input volume of the local participant.

Declaration
[Obsolete]
public float ConferenceLocalInputVolume { get; }
Property Value
Type Description
System.Single

A value inside [0.0 ; 1.0]
Remarks

Deprecated : 23/01/2025 Use Linphone.Conference.InputVolume instead.

ConferenceMaxThumbnails

Gets the maximum number of thumbnails requested in the SDP during a conference call Linphone.Account.CallLogs.

Declaration
public int ConferenceMaxThumbnails { get; set; }
Property Value
Type Description
System.Int32

the maximum number of thumbnails requested in the SDP during a conference call

ConferenceParticipantListType

Tells whether the default conference participant list is open or closed.

Declaration
public ConferenceParticipantListType ConferenceParticipantListType { get; set; }
Property Value
Type Description
ConferenceParticipantListType

A Linphone.ConferenceParticipantListType participant list type

ConferenceServerEnabled

Tells whether the conference server feature is enabled.

Declaration
public bool ConferenceServerEnabled { get; set; }
Property Value
Type Description
System.Boolean

A boolean value telling whether the conference server feature is enabled or not

Config

Returns the config object used to manage the storage (config) file.

Declaration
public Config Config { get; }
Property Value
Type Description
Config

a Linphone.Config object. @notnil

ConsolidatedPresence

Gets my consolidated presence.

Declaration
public ConsolidatedPresence ConsolidatedPresence { get; set; }
Property Value
Type Description
ConsolidatedPresence

My Linphone.ConsolidatedPresence presence

CurrentCall

Gets the current call.

The current call is defined as follows: If multiple concurrent calls exist, it is the only one that currelty uses the microphone or speaker, otherwise it is the unique call that exists unless this call is in Linphone.CallState.Paused state.

Declaration
public Call CurrentCall { get; }
Property Value
Type Description
Call

The current call or null if no call is running. @maybenil

CurrentCallRemoteAddress

Gets the remote address of the current call.

Declaration
public Address CurrentCallRemoteAddress { get; }
Property Value
Type Description
Address

The remote address of the current call or null if there is no current call. @maybenil

CurrentPreviewVideoDefinition

Get the effective video definition provided by the camera for the captured video.

When preview is disabled or not yet started this function returns a 0x0 video definition.

Declaration
public VideoDefinition CurrentPreviewVideoDefinition { get; }
Property Value
Type Description
VideoDefinition

The captured Linphone.VideoDefinition. @notnil
Remarks

See : Linphone.Core.PreviewVideoDefinition

DatabaseEnabled

Returns whether the database is enabled.

Declaration
public bool DatabaseEnabled { get; set; }
Property Value
Type Description
System.Boolean

a boolean indicating the enablement of the database.

DefaultAccount

Returns the default account, that is the one used to determine the current identity.

Declaration
public Account DefaultAccount { get; set; }
Property Value
Type Description
Account

The default account. @maybenil

DefaultConferenceLayout

Gets the default conference layout.

Declaration
public ConferenceLayout DefaultConferenceLayout { get; set; }
Property Value
Type Description
ConferenceLayout

conference layout

DefaultEphemeralLifetime

Gets the default lifetime of ephemeral messages in seconds once they are read.

Declaration
public int DefaultEphemeralLifetime { get; set; }
Property Value
Type Description
System.Int32

lifetime of ephemeral messages in seconds once read

DefaultEphemeralMode

Gets the default ephemeral message mode.

Declaration
public ChatRoomEphemeralMode DefaultEphemeralMode { get; set; }
Property Value
Type Description
ChatRoomEphemeralMode

the default ephemeral message mode Linphone.ChatRoomEphemeralMode

DefaultEphemeralNotReadLifetime

Gets the default lifetime of ephemeral messages in seconds when they are not read.

Declaration
public int DefaultEphemeralNotReadLifetime { get; set; }
Property Value
Type Description
System.Int32

lifetime of ephemeral messages in seconds when not read

DefaultFriendList

Retrieves the first list of Linphone.Friend from the core.

Declaration
public FriendList DefaultFriendList { get; }
Property Value
Type Description
FriendList

the first Linphone.FriendList object or null. @maybenil

DefaultInputAudioDevice

Gets the default input audio device.

Declaration
public AudioDevice DefaultInputAudioDevice { get; set; }
Property Value
Type Description
AudioDevice

The default input audio device @maybenil

DefaultOutputAudioDevice

Gets the default output audio device.

Declaration
public AudioDevice DefaultOutputAudioDevice { get; set; }
Property Value
Type Description
AudioDevice

The default output audio device @maybenil

DefaultProxyConfig

Returns the default proxy configuration, that is the one used to determine the current identity.

Declaration
[Obsolete]
public ProxyConfig DefaultProxyConfig { get; set; }
Property Value
Type Description
ProxyConfig

The default proxy configuration. @maybenil
Remarks

Deprecated : 04/09/2024 Use Linphone.Core.DefaultAccount

DefaultVideoDisplayFilter

Gets the name of the default mediastreamer2 filter used for rendering video on the current platform.

This is for advanced users of the library, mainly to expose mediastreamer video filter name and status.

Declaration
public string DefaultVideoDisplayFilter { get; }
Property Value
Type Description
System.String

The default video display filter. @notnil

DelayedTimeout

Gets the delayed timeout See Linphone.Core.DelayedTimeout for details.

Declaration
[Obsolete]
public int DelayedTimeout { get; set; }
Property Value
Type Description
System.Int32

The current delayed timeout in seconds
Remarks

Deprecated : 04/09/2024 Obscure.

DeviceRotation

Gets the current device orientation.

Declaration
public int DeviceRotation { get; set; }
Property Value
Type Description
System.Int32

The current device orientation
Remarks

See : Linphone.Core.DeviceRotation

DigestAuthenticationPolicy

Get the current digest authentication policy applicable for SIP and HTTP.

Declaration
public DigestAuthenticationPolicy DigestAuthenticationPolicy { get; set; }
Property Value
Type Description
DigestAuthenticationPolicy

The current digest authentication policy. @notnil

DisableRecordOnMute

Get whether the microphone will be completely deactivated when muted.

Please refer to Linphone.Core.DisableRecordOnMute.

Declaration
public bool DisableRecordOnMute { get; set; }
Property Value
Type Description
System.Boolean

True if you wish to entirely stop the audio recording when muting the microphone.

DnsSearchEnabled

Tells whether DNS search (use of local domain if the fully qualified name did return results) is enabled.

Declaration
public bool DnsSearchEnabled { get; set; }
Property Value
Type Description
System.Boolean

true if DNS search is enabled, false if disabled.

DnsServers

Forces liblinphone to use the supplied list of dns servers, instead of system's ones.

Declaration
public IEnumerable<string> DnsServers { set; }
Property Value
Type Description
System.Collections.Generic.IEnumerable<System.String>

DnsServersApp

Forces liblinphone to use the supplied list of dns servers, instead of system's ones and set dns_set_by_app at true or false according to value of servers list.

Declaration
public IEnumerable<string> DnsServersApp { set; }
Property Value
Type Description
System.Collections.Generic.IEnumerable<System.String>
Remarks

See : Linphone.Core.DnsSetByApp

DnsSetByApp

Tells if the DNS was set by an application.

Declaration
public bool DnsSetByApp { get; }
Property Value
Type Description
System.Boolean

true if DNS was set by app, false otherwise.

DnsSrvEnabled

Tells whether DNS SRV resolution is enabled.

Declaration
public bool DnsSrvEnabled { get; set; }
Property Value
Type Description
System.Boolean

true if DNS SRV resolution is enabled, false if disabled.

DownloadBandwidth

Retrieve the maximum available download bandwidth.

This value was set by Linphone.Core.DownloadBandwidth.

Declaration
public int DownloadBandwidth { get; set; }
Property Value
Type Description
System.Int32

the download bandiwdth in kbits/s, 0 for unknown.

DownloadPtime

Get audio packetization time linphone expects to receive from peer.

A value of zero means that ptime is not specified.

Declaration
public int DownloadPtime { get; set; }
Property Value
Type Description
System.Int32

the download packetization time set

EchoCancellationCalibration

Gets the currently stored calibration delay for the software echo cancellation.

Declaration
public int EchoCancellationCalibration { get; }
Property Value
Type Description
System.Int32

the current calibration value, -1 if it failed, 0 if not done or not needed, a positive value if a software echo canceller is required after running Linphone.Core.StartEchoCancellerCalibration().

EchoCancellationEnabled

Returns true if echo cancellation is enabled.

Declaration
public bool EchoCancellationEnabled { get; set; }
Property Value
Type Description
System.Boolean

A boolean value telling whether echo cancellation is enabled or disabled

EchoCancellerFilterName

Gets the name of the mediastreamer2 filter used for echo cancelling.

Declaration
public string EchoCancellerFilterName { get; set; }
Property Value
Type Description
System.String

The name of the mediastreamer2 filter used for echo cancellation. @maybenil

EchoLimiterEnabled

Tells whether echo limiter is enabled.

Enables or disable echo limiter. "Echo limiter" refers to an algorithm that creates half-duplex conversation in order to suppress echo. It is experimental and shall be used only in rare cases where echo cancellation cannot perform because of non-linear speaker/mic coupling. You shall not expected good audio quality with the echo limiter.

Declaration
public bool EchoLimiterEnabled { get; set; }
Property Value
Type Description
System.Boolean

true if the echo limiter is enabled, false otherwise.

EktPluginLoaded

sets the state of the EKT plugin in the Linphone core instance.

Declaration
public bool EktPluginLoaded { set; }
Property Value
Type Description
System.Boolean

EmptyChatroomsDeletionEnabled

Tells whether empty chat rooms are deleted or not.

Declaration
public bool EmptyChatroomsDeletionEnabled { get; set; }
Property Value
Type Description
System.Boolean

A boolean value telling whether the deletion of empty chatrooms is enabled or not (Applicable to servers only)

EnableSipUpdate

Enable or disable the UPDATE method support.

Declaration
public int EnableSipUpdate { set; }
Property Value
Type Description
System.Int32

EphemeralChatMessagePolicy

Gets the current policy for ephemeral chat messages.

See Linphone.EphemeralChatMessagePolicy for more details.

Declaration
public EphemeralChatMessagePolicy EphemeralChatMessagePolicy { get; set; }
Property Value
Type Description
EphemeralChatMessagePolicy

the current Linphone.EphemeralChatMessagePolicy.

ExpectedBandwidth

Do not use, this function does nothing.

Declaration
[Obsolete]
public int ExpectedBandwidth { set; }
Property Value
Type Description
System.Int32
Remarks

Deprecated : 04/09/2024 this function does nothing.

ExtendedAudioDevices

Returns the list of all audio devices.

Declaration
public IEnumerable<AudioDevice> ExtendedAudioDevices { get; }
Property Value
Type Description
System.Collections.Generic.IEnumerable<AudioDevice>

A list of all Linphone.AudioDevice @maybenil

FecEnabled

Tells whether the flexible FEC feature (RFC8627) is enabled for this Linphone.Core object.

Declaration
public bool FecEnabled { get; set; }
Property Value
Type Description
System.Boolean

A boolean value telling whether the flexible FEC feature is enabled or not for this Linphone.Core object

FileTransferServer

Gets the globaly set http file transfer server to be used for content type application/vnd.gsma.rcs-ft-http+xml.

Url may be like: "https://file.linphone.org/upload.php".

Declaration
public string FileTransferServer { get; set; }
Property Value
Type Description
System.String

URL of the file server. @maybenil

ForcedIceRelayEnabled

Indicates whether the ICE relay path is forcibly selected.

Declaration
public bool ForcedIceRelayEnabled { get; set; }
Property Value
Type Description
System.Boolean

a boolean value indicating whether forced relay is enabled.
Remarks

See : Linphone.Core.EnableForcedIceRelay().

FriendListSubscriptionEnabled

Returns whether or not friend lists subscription are enabled.

Declaration
public bool FriendListSubscriptionEnabled { get; set; }
Property Value
Type Description
System.Boolean

whether or not the feature is enabled

FriendsDatabasePath

Gets the database filename where friends will be stored.

Declaration
[Obsolete]
public string FriendsDatabasePath { get; set; }
Property Value
Type Description
System.String

filesystem path. @maybenil
Remarks

Deprecated : 27/10/2023 Friends are now stored in the main db

FriendsLists

Retrieves the list of Linphone.FriendList from the core.

Declaration
public IEnumerable<FriendList> FriendsLists { get; }
Property Value
Type Description
System.Collections.Generic.IEnumerable<FriendList>

A list of Linphone.FriendList. @maybenil

FutureConferenceInformationList

Retrieve the list of future conference information on DB.

Declaration
public IEnumerable<ConferenceInfo> FutureConferenceInformationList { get; }
Property Value
Type Description
System.Collections.Generic.IEnumerable<ConferenceInfo>

The list of future conference infos . @maybenil

GenericComfortNoiseEnabled

Returns enablement of RFC3389 generic comfort noise algorithm.

Declaration
public bool GenericComfortNoiseEnabled { get; set; }
Property Value
Type Description
System.Boolean

true if generic comfort noise is enabled, false otherwise.

GlobalState

Returns the global state of core.

Declaration
public GlobalState GlobalState { get; }
Property Value
Type Description
GlobalState

a Linphone.GlobalState enum. @notnil

GruuInConferenceAddressEnabled

Returns whether the gr parameter is kept in the conference address.

Declaration
public bool GruuInConferenceAddressEnabled { get; set; }
Property Value
Type Description
System.Boolean

true if the "gr" parameter is kept in the conference address, false otherwise.
Remarks

See : Linphone.Core.EnableGruuInConferenceAddress() for more informations

GuessHostname

Returns true if hostname part of primary contact is guessed automatically.

Declaration
public bool GuessHostname { get; set; }
Property Value
Type Description
System.Boolean

true if guess hostname enabled, false otherwise.

HttpProxyHost

Gets http proxy address to be used for signaling.

Declaration
public string HttpProxyHost { get; set; }
Property Value
Type Description
System.String

hostname of IP adress of the http proxy (can be null to disable). @maybenil

HttpProxyPort

Gets http proxy port to be used for signaling.

Declaration
public int HttpProxyPort { get; set; }
Property Value
Type Description
System.Int32

port of the http proxy.

Identity

Gets the default identity SIP address.

This is an helper function. If no default proxy is set, this will return the primary contact ( see Linphone.Core.PrimaryContact ). If a default proxy is set it returns the registered identity on the proxy.

Declaration
public string Identity { get; }
Property Value
Type Description
System.String

The default identity SIP address. @notnil

ImdnResendPeriod

Gets the IMDN resend period.

Declaration
public int ImdnResendPeriod { get; set; }
Property Value
Type Description
System.Int32

the number of second to resend an failed IMDN message

ImdnToEverybodyThreshold

Returns the threshold for sending IMDN to all participants to a Linphone.ChatRoom.

Declaration
public int ImdnToEverybodyThreshold { get; set; }
Property Value
Type Description
System.Int32

An integer value telling the threshold for sending IMDN to all participants to a Linphone.ChatRoom

ImNotifPolicy

Gets the Linphone.ImNotifPolicy object controlling the instant messaging delivery and displayed service notifications.

Declaration
public ImNotifPolicy ImNotifPolicy { get; }
Property Value
Type Description
ImNotifPolicy

A Linphone.ImNotifPolicy object. @maybenil

InCallTimeout

Gets the maximum duration of a call.

See Linphone.Core.InCallTimeout for details.

Declaration
public int InCallTimeout { get; set; }
Property Value
Type Description
System.Int32

The current in call timeout in seconds

IncTimeout

Returns the incoming call timeout See Linphone.Core.IncTimeout for details.

Declaration
public int IncTimeout { get; set; }
Property Value
Type Description
System.Int32

The current incoming call timeout in seconds

InputAudioDevice

Gets the input audio device for the current call.

Declaration
public AudioDevice InputAudioDevice { get; set; }
Property Value
Type Description
AudioDevice

The input audio device for the current or first call, null if there is no call. @maybenil

Ipv6Enabled

Tells whether IPv6 is enabled or not.

Declaration
public bool Ipv6Enabled { get; set; }
Property Value
Type Description
System.Boolean

A boolean value telling whether IPv6 is enabled or not

IsAutoDownloadIcalendarsEnabled

Gets if the automatic download of incoming icalendars is enabled or not.

Declaration
[Obsolete]
public bool IsAutoDownloadIcalendarsEnabled { get; }
Property Value
Type Description
System.Boolean

true if icalendars will be automatically downloaded, false otherwise.
Remarks

Deprecated : 16/12/2021 Use Linphone.Core.AutoDownloadIcalendarsEnabled() instead.

IsAutoDownloadVoiceRecordingsEnabled

Gets if the auto download for incoming voice recordings is enabled or not.

Declaration
[Obsolete]
public bool IsAutoDownloadVoiceRecordingsEnabled { get; }
Property Value
Type Description
System.Boolean

true if voice recordings will be automatically downloaded, false otherwise.
Remarks

Deprecated : 16/12/2021 Use Linphone.Core.AutoDownloadVoiceRecordingsEnabled() instead.

IsAutoIterateEnabled

Gets whether auto iterate is enabled or not (Android & iOS only).

Declaration
[Obsolete]
public bool IsAutoIterateEnabled { get; }
Property Value
Type Description
System.Boolean

true if Linphone.Core.Iterate() is scheduled automatically, false otherwise
Remarks

Deprecated : 16/12/2021 Use Linphone.Core.AutoIterateEnabled() instead.

IsEchoCancellerCalibrationRequired

Check whether the device is echo canceller calibration is required.

Declaration
public bool IsEchoCancellerCalibrationRequired { get; }
Property Value
Type Description
System.Boolean

true if it is required, false otherwise

IsEktPluginLoaded

Gets if the EKT plugin is currently loaded in the Linphone core instance.

Declaration
public bool IsEktPluginLoaded { get; }
Property Value
Type Description
System.Boolean

true if the EKT plugin is loaded

IsFriendListSubscriptionEnabled

Returns whether or not friend lists subscription are enabled.

Declaration
[Obsolete]
public bool IsFriendListSubscriptionEnabled { get; }
Property Value
Type Description
System.Boolean

whether or not the feature is enabled
Remarks

Deprecated : 16/12/2021 Use Linphone.Core.FriendListSubscriptionEnabled() instead.

IsInBackground

Gets whether the Core is considering itself in background or not.

The Core foreground/background state depends on the last call made to Linphone.Core.EnterBackground() or Linphone.Core.EnterForeground().

Declaration
public bool IsInBackground { get; }
Property Value
Type Description
System.Boolean

true if the Core is in background, false otherwise.

IsIncomingInvitePending

Tells whether there is an incoming invite pending.

Declaration
public bool IsIncomingInvitePending { get; }
Property Value
Type Description
System.Boolean

A boolean telling whether an incoming invite is pending or not.

IsInConference

Indicates whether the local participant is part of a conference.

Declaration
[Obsolete]
public bool IsInConference { get; }
Property Value
Type Description
System.Boolean

true if the local participant is in a conference, false otherwise.
Remarks

Warning : That function automatically fails in the case of conferences using a conferencet server (focus). If you use such a conference, you should use Linphone.Conference.RemoveParticipant() instead.

IsMediaEncryptionMandatory

Checks if the configured media encryption is mandatory or not.

Declaration
public bool IsMediaEncryptionMandatory { get; }
Property Value
Type Description
System.Boolean

true if media encryption is mandatory; false otherwise.

IsNativeRingingEnabled

Returns whether the native ringing is enabled or not.

Declaration
[Obsolete]
public bool IsNativeRingingEnabled { get; }
Property Value
Type Description
System.Boolean

True if we use the native ringing, false otherwise
Remarks

Deprecated : 16/12/2021 Use Linphone.Core.NativeRingingEnabled() instead.

IsNetworkReachable

return network state either as positioned by the application or by linphone itself.

Declaration
public bool IsNetworkReachable { get; }
Property Value
Type Description
System.Boolean

true if network is reachable, false otherwise

IsPushNotificationAvailable

Gets whether push notifications are available or not (Android & iOS only).

Declaration
public bool IsPushNotificationAvailable { get; }
Property Value
Type Description
System.Boolean

true if push notifications are available, false otherwise

IsPushNotificationEnabled

Gets whether push notifications are enabled or not (Android & iOS only).

If not, the app will have to handle all the push-related settings for each accounts

Declaration
[Obsolete]
public bool IsPushNotificationEnabled { get; }
Property Value
Type Description
System.Boolean

true if push notifications are enabled, false otherwise
Remarks

Deprecated : 16/12/2021 Use Linphone.Core.PushNotificationEnabled() instead.

IsRecordAwareEnabled

Gets if the record aware feature is enabled or not.

Declaration
[Obsolete]
public bool IsRecordAwareEnabled { get; }
Property Value
Type Description
System.Boolean

true if the record aware feature is enabled, false otherwise.
Remarks

Deprecated : 16/12/2021 Use Linphone.Core.RecordAwareEnabled() instead.

IsSenderNameHiddenInForwardMessage

Returns whether or not sender name is hidden in a forwarded message.

Declaration
public bool IsSenderNameHiddenInForwardMessage { get; }
Property Value
Type Description
System.Boolean

whether or not the feature

IsVerifyServerCertificates

Get whether the tls server certificate must be verified when connecting to a SIP/TLS server.

Declaration
public bool IsVerifyServerCertificates { get; }
Property Value
Type Description
System.Boolean

True if the tls server certificate must be verified

IsVerifyServerCn

Get whether the tls server certificate common name must be verified when connecting to a SIP/TLS server.

Declaration
public bool IsVerifyServerCn { get; }
Property Value
Type Description
System.Boolean

True if the tls server certificate common name must be verified

IsVibrationOnIncomingCallEnabled

Gets whether the device will vibrate while an incoming call is ringing (Android only).

Declaration
[Obsolete]
public bool IsVibrationOnIncomingCallEnabled { get; }
Property Value
Type Description
System.Boolean

true if the device will vibrate (if possible), false otherwise
Remarks

Deprecated : 16/12/2021 Use Linphone.Core.VibrationOnIncomingCallEnabled() instead.

KeepAliveEnabled

Is signaling keep alive enabled.

Declaration
public bool KeepAliveEnabled { get; set; }
Property Value
Type Description
System.Boolean

A boolean value telling whether signaling keep alive is enabled

Label

Get the label assigned to the LinphoneCore.

The default value is null (no label).

Declaration
public string Label { get; set; }
Property Value
Type Description
System.String

the assigned label.

LastOutgoingCallLog

Gets the latest outgoing call log.

Conference calls are not returned by this function! Requires ENABLE_DB_STORAGE to work.

Declaration
public CallLog LastOutgoingCallLog { get; }
Property Value
Type Description
CallLog

The last outgoing call log if any. @maybenil

LdapList

Returns a list of entered LDAPs.

Items must be freed with linphone_ldap_unref

Declaration
[Obsolete]
public IEnumerable<Ldap> LdapList { get; }
Property Value
Type Description
System.Collections.Generic.IEnumerable<Ldap>

@maybenil
Remarks

Deprecated : 18/11/2024 use Linphone.Core.RemoteContactDirectories instead.

LimeX3DhEnabled

Tells wether LIME X3DH is enabled or not.

Declaration
public bool LimeX3DhEnabled { get; set; }
Property Value
Type Description
System.Boolean

The current lime state

LimeX3DhServerUrl

Get the x3dh server url.

Declaration
[Obsolete]
public string LimeX3DhServerUrl { get; set; }
Property Value
Type Description
System.String

The x3dh server url. @maybenil
Remarks

Deprecated : 26/08/2022 Use Linphone.AccountParams.LimeServerUrl instead.

LinphoneSpecsList

Get the list of linphone specs string values representing what functionalities the linphone client supports.

Declaration
public IEnumerable<string> LinphoneSpecsList { get; set; }
Property Value
Type Description
System.Collections.Generic.IEnumerable<System.String>

A list of supported specs. The list must be freed with bctbx_list_free() after usage. @maybenil
Remarks

See : Linphone.Core.LinphoneSpecsList

Listener

Declaration
public CoreListener Listener { get; set; }
Property Value
Type Description
CoreListener

LoadedPlugins

Return the list of loaded plugins.

Declaration
public IEnumerable<string> LoadedPlugins { get; }
Property Value
Type Description
System.Collections.Generic.IEnumerable<System.String>

the list of loaded plugins @maybenil

LocalPermissionEnabled

Special function to check if the local network permission has been granted by the user (useful for iOS).

The test performed by this function may popup the local network permission dialog, for that reason it could be a good idea to check it twice to conclude that the user has deny the permission.

Declaration
public bool LocalPermissionEnabled { get; }
Property Value
Type Description
System.Boolean

true if local permission request is granted, false otherwise.

LogCollectionMaxFileSize

Gets the max file size in bytes of the files used for log collection.

Declaration
public static long LogCollectionMaxFileSize { get; }
Property Value
Type Description
System.Int64

The max file size in bytes of the files used for log collection. @notnil

LogCollectionPath

Gets the path where the log files will be written for log collection.

Declaration
public static string LogCollectionPath { get; }
Property Value
Type Description
System.String

The path where the log files will be written. @notnil

LogCollectionPrefix

Gets the prefix of the filenames that will be used for log collection.

Declaration
public static string LogCollectionPrefix { get; }
Property Value
Type Description
System.String

The prefix of the filenames used for log collection. @notnil

LogCollectionUploadServerUrl

Gets the url of the server where to upload the collected log files.

Declaration
public string LogCollectionUploadServerUrl { get; set; }
Property Value
Type Description
System.String

The url of the server where to upload the collected log files. @maybenil

MaxCallLogs

Gets the maximum number of call logs retrieved when using Linphone.Core.CallLogs or Linphone.Account.CallLogs.

Declaration
public int MaxCallLogs { get; set; }
Property Value
Type Description
System.Int32

the maximum number of call logs that will be returned. -1 will return them all.

MaxCalls

Gets the maximum number of simultaneous calls Linphone core can manage at a time.

All new call above this limit are declined with a busy answer

Declaration
public int MaxCalls { get; set; }
Property Value
Type Description
System.Int32

maximum number of simultaneous calls

MaxSizeForAutoDownloadIncomingFiles

Gets the size under which incoming files in chat messages will be downloaded automatically.

Declaration
public int MaxSizeForAutoDownloadIncomingFiles { get; set; }
Property Value
Type Description
System.Int32

The size in bytes, -1 if autodownload feature is disabled, 0 to download them all no matter the size

MediaDevice

Gets the name of the currently assigned sound device for media.

Declaration
public string MediaDevice { get; set; }
Property Value
Type Description
System.String

The name of the currently assigned sound device for capture. @maybenil

MediaEncryption

Gets the media encryption type being used for RTP packets.

Declaration
public MediaEncryption MediaEncryption { get; set; }
Property Value
Type Description
MediaEncryption

The Linphone.MediaEncryption policy being used.

MediaEncryptionMandatory

Defines whether the configured media encryption is mandatory, if it is and the negotation cannot result in the desired media encryption then the call will fail.

If not an INVITE will be resent with encryption disabled.

Declaration
public bool MediaEncryptionMandatory { set; }
Property Value
Type Description
System.Boolean

MediaNetworkReachable

This method is called by the application to notify the linphone core library when the media (RTP) network is reachable.

This is for advanced usage, when SIP and RTP layers are required to use different interfaces. Most applications just need Linphone.Core.NetworkReachable.

Declaration
public bool MediaNetworkReachable { set; }
Property Value
Type Description
System.Boolean

MediaResourceMode

This function returns the media resource mode for this core.

Declaration
public MediaResourceMode MediaResourceMode { get; set; }
Property Value
Type Description
MediaResourceMode

The media resource mode

MessageAutomaticResendingDelay

Returns the duration of the timer that delays the automatic resending of chat messages.

Declaration
public int MessageAutomaticResendingDelay { get; set; }
Property Value
Type Description
System.Int32

the duration of the timer in seconds

MessageSendingDelay

Returns the duration of the timer that delays the sending of chat messages.

Declaration
public int MessageSendingDelay { get; set; }
Property Value
Type Description
System.Int32

the duration of the timer in seconds

MicEnabled

Tells whether the microphone is enabled.

Declaration
public bool MicEnabled { get; set; }
Property Value
Type Description
System.Boolean

true if the microphone is enabled, false if disabled.

MicGainDb

Get microphone gain in db.

Declaration
public float MicGainDb { get; set; }
Property Value
Type Description
System.Single

The current microphone gain

MissedCallsCount

Gets the number of missed calls.

Once checked, this counter can be reset with Linphone.Core.ResetMissedCallsCount().

Declaration
public int MissedCallsCount { get; }
Property Value
Type Description
System.Int32

The number of missed calls.

MsFactory

Declaration
public MediastreamerFactory MsFactory { get; }
Property Value
Type Description
MediastreamerFactory

Mtu

Returns the maximum transmission unit size in bytes.

Declaration
public int Mtu { get; set; }
Property Value
Type Description
System.Int32

NatAddress

Deprecated.

Get the public IP address of NAT being used.

Declaration
[Obsolete]
public string NatAddress { get; set; }
Property Value
Type Description
System.String

The public IP address of NAT being used. @maybenil
Remarks

Deprecated : 12/10/2022 Use Linphone.Core.NatPolicy

NativePreviewWindowId

Get the native window handle of the video preview window. On Windows UWP/WindowsStore, this is a SwapChainPanel. eg: LinphoneManager.Instance.Core.NativePreviewWindowId = panel; The rendering is automatically done by Linphone.

Declaration
public IntPtr NativePreviewWindowId { get; set; }
Property Value
Type Description
System.IntPtr

NativePreviewWindowIdString

Declaration
public string NativePreviewWindowIdString { get; set; }
Property Value
Type Description
System.String

NativeRingingEnabled

Returns whether the native ringing is enabled or not.

This property is meaningful for Android platform only. When set to true, the incoming call's ring tone is played by a Android MediaPlayer object playing the phone's default ringtone, and manages vibrator as well. When set to false, the incoming call's ring tone is played using liblinphone's internal ring tone player, that is generic for all platforms.

Declaration
public bool NativeRingingEnabled { get; set; }
Property Value
Type Description
System.Boolean

True if we use the native ringing, false otherwise

NativeVideoWindowId

Get the native window handle of the video window. On Windows UWP/WindowsStore, this is a SwapChainPanel. eg: LinphoneManager.Instance.Core.NativeVideoWindowId = panel; The rendering is automatically done by Linphone.

Declaration
public IntPtr NativeVideoWindowId { get; set; }
Property Value
Type Description
System.IntPtr

NativeVideoWindowIdString

Declaration
public string NativeVideoWindowIdString { get; set; }
Property Value
Type Description
System.String

NatPolicy

Get The policy that is used to pass through NATs/firewalls.

It may be overridden by a NAT policy for a specific proxy config.

Declaration
public NatPolicy NatPolicy { get; set; }
Property Value
Type Description
NatPolicy

Linphone.NatPolicy object in use. @maybenil
Remarks

See : Linphone.AccountParams.NatPolicy

NetworkReachable

This method is called by the application to notify the linphone core library when network is reachable.

Calling this method with true trigger linphone to initiate a registration process for all proxies. Calling this method disables the automatic network detection mode. It means you must call this method after each network state changes.

Declaration
public bool NetworkReachable { set; }
Property Value
Type Description
System.Boolean

NoiseSuppressionEnabled

Indicates whether software noise suppression is enabled.

This does not provide information about hardware noise suppression.

Declaration
public bool NoiseSuppressionEnabled { get; set; }
Property Value
Type Description
System.Boolean

true if the software noise suppression is enabled, false if disabled.

NortpOnholdTimeout

Gets the value of the no-rtp timeout when the call is on hold.

When no RTP or RTCP packets have been received for a while when the call is on hold Linphone.Core will consider the call is broken (remote end crashed or disconnected from the network), and thus will terminate the call. The no-rtp timeout is the duration above which the call is considered broken.

Declaration
public int NortpOnholdTimeout { get; set; }
Property Value
Type Description
System.Int32

The value of the no-rtp timeout in seconds when the call is on hold

NortpTimeout

Gets the value of the no-rtp timeout.

When no RTP or RTCP packets have been received for a while Linphone.Core will consider the call is broken (remote end crashed or disconnected from the network), and thus will terminate the call. The no-rtp timeout is the duration above which the call is considered broken.

Declaration
public int NortpTimeout { get; set; }
Property Value
Type Description
System.Int32

The value of the no-rtp timeout in seconds

OutputAudioDevice

Gets the output audio device for the current call.

Declaration
public AudioDevice OutputAudioDevice { get; set; }
Property Value
Type Description
AudioDevice

The output audio device for the current or first call, null if there is no call. @maybenil

PlaybackDevice

Gets the name of the currently assigned sound device for playback.

Declaration
[Obsolete]
public string PlaybackDevice { get; set; }
Property Value
Type Description
System.String

The name of the currently assigned sound device for playback. @maybenil
Remarks

Deprecated : 11/09/2024 use Linphone.Core.OutputAudioDevice or Linphone.Core.DefaultOutputAudioDevice instead.

PlaybackGainDb

Gets playback gain in db (before entering sound card).

Declaration
public float PlaybackGainDb { get; set; }
Property Value
Type Description
System.Single

The current playback gain

PlayFile

Get the wav file that is played when files are used instead of soundcards (see Linphone.Core.UseFiles).

The file is a 16 bit linear wav file.

Declaration
public string PlayFile { get; set; }
Property Value
Type Description
System.String

The path to the file that is played when files are used instead of soundcards. @maybenil

PostQuantumAvailable

Are PostQuantum algoritms available.

Declaration
public static bool PostQuantumAvailable { get; }
Property Value
Type Description
System.Boolean

true if Post Quantum algorithms are available false otherwise

PreferredFramerate

Returns the preferred video framerate, previously set by Linphone.Core.PreferredFramerate.

Declaration
public float PreferredFramerate { get; set; }
Property Value
Type Description
System.Single

frame rate in number of frames per seconds.

PreferredVideoDefinition

Get the preferred video definition for the stream that is captured and sent to the remote party.

Declaration
public VideoDefinition PreferredVideoDefinition { get; set; }
Property Value
Type Description
VideoDefinition

The preferred Linphone.VideoDefinition @notnil

PreferredVideoDefinitionByName

Sets the preferred video definition by its name.

Call Linphone.Factory.SupportedVideoDefinitions to have a list of supported video definitions.

Declaration
public string PreferredVideoDefinitionByName { set; }
Property Value
Type Description
System.String

PresenceModel

Gets my presence model.

Declaration
public PresenceModel PresenceModel { get; set; }
Property Value
Type Description
PresenceModel

A Linphone.PresenceModel object, or null if no presence model has been set. @maybenil

PreviewVideoDefinition

Get the definition of the captured video.

Declaration
public VideoDefinition PreviewVideoDefinition { get; set; }
Property Value
Type Description
VideoDefinition

The captured Linphone.VideoDefinition if it was previously set by Linphone.Core.PreviewVideoDefinition, otherwise a 0x0 LinphoneVideoDefinition. @maybenil
Remarks

See : Linphone.Core.PreviewVideoDefinition

PreviewVideoDefinitionByName

-Set the video definition for the captured (preview) video by its name. Call Linphone.Factory.SupportedVideoDefinitions to have a list of supported video definitions. Video resolution names are: qcif, svga, cif, vga, 4cif, svga ...

Declaration
public string PreviewVideoDefinitionByName { set; }
Property Value
Type Description
System.String

PrimaryContact

Returns the default identity when no account is used.

This SIP address usually contains a private ip address, and may not be routable globally.

Declaration
public string PrimaryContact { get; set; }
Property Value
Type Description
System.String

the primary contact identity @notnil

PrimaryContactAddress

Same as Linphone.Core.PrimaryContact but the result is a Linphone.Address object instead of a string.

Declaration
public Address PrimaryContactAddress { get; }
Property Value
Type Description
Address

a Linphone.Address object. @maybenil

PrimaryContactParsed

Same as Linphone.Core.PrimaryContact but the result is a Linphone.Address object instead of const char *.

Declaration
[Obsolete]
public Address PrimaryContactParsed { get; }
Property Value
Type Description
Address

a Linphone.Address object. @maybenil
Remarks

Deprecated : 22/10/2018 Use Linphone.Core.CreatePrimaryContactParsed() instead.

ProvisioningUri

Get provisioning URI.

Declaration
public string ProvisioningUri { get; set; }
Property Value
Type Description
System.String

the provisioning URI. @maybenil

ProxyConfigList

Returns an unmodifiable list of entered proxy configurations.

Declaration
[Obsolete]
public IEnumerable<ProxyConfig> ProxyConfigList { get; }
Property Value
Type Description
System.Collections.Generic.IEnumerable<ProxyConfig>

A list of Linphone.ProxyConfig. @maybenil
Remarks

Deprecated : 04/09/2024 Use Linphone.Core.AccountList

PushIncomingCallTimeout

Returns the push incoming call timeout See Linphone.Core.PushIncomingCallTimeout for details.

Declaration
public int PushIncomingCallTimeout { get; set; }
Property Value
Type Description
System.Int32

The current push incoming call timeout in seconds

PushNotificationConfig

Gets the push notification configuration object if it exists.

Declaration
public PushNotificationConfig PushNotificationConfig { get; }
Property Value
Type Description
PushNotificationConfig

the Linphone.PushNotificationConfig if it exists, null otherwise. @maybenil

PushNotificationEnabled

Gets whether push notifications are enabled or not (Android & iOS only).

If not, the app will have to handle all the push-related settings for each accounts

Declaration
public bool PushNotificationEnabled { get; set; }
Property Value
Type Description
System.Boolean

true if push notifications are enabled, false otherwise

QrcodeVideoPreviewEnabled

Tells whether QRCode is enabled in the preview.

Declaration
public bool QrcodeVideoPreviewEnabled { get; set; }
Property Value
Type Description
System.Boolean

A boolean value telling whether QRCode is enabled in the preview.

QueuedMessageResendPeriod

Gets the queued message resend period.

Declaration
public int QueuedMessageResendPeriod { get; set; }
Property Value
Type Description
System.Int32

the number of second to resend a queued message

RealtimeTextEnabled

Gets if realtime text is enabled or not (RFC4103).

Declaration
public bool RealtimeTextEnabled { get; }
Property Value
Type Description
System.Boolean

true if realtime text is enabled, false otherwise

RealtimeTextKeepaliveInterval

Gets keep alive interval of real time text (RFC4103).

Declaration
public uint RealtimeTextKeepaliveInterval { get; set; }
Property Value
Type Description
System.UInt32

keep alive interval of real time text.

RecordAwareEnabled

Gets if the record aware feature is enabled or not.

Declaration
public bool RecordAwareEnabled { get; set; }
Property Value
Type Description
System.Boolean

true if the record aware feature is enabled, false otherwise.

RecordFile

Get the wav file where incoming stream is recorded, when files are used instead of soundcards (see Linphone.Core.UseFiles).

This feature is different from call recording ( Linphone.CallParams.RecordFile) The file is a 16 bit linear wav file.

Declaration
public string RecordFile { get; set; }
Property Value
Type Description
System.String

The path to the file where incoming stream is recorded. @maybenil

RegisterOnlyWhenNetworkIsUp

Gets if accounts will wait for network to be connected before trying to REGISTER or not.

Declaration
public bool RegisterOnlyWhenNetworkIsUp { get; set; }
Property Value
Type Description
System.Boolean

true if accounts will wait for internet connection before trying to REGISTER, false otherwise.

RemainingDownloadFileCount

Returns how many attachments are yet to be downloaded.

Declaration
public uint RemainingDownloadFileCount { get; }
Property Value
Type Description
System.UInt32

how many attachments are yet to be downloaded.

RemainingUploadFileCount

Returns how many attachments are yet to be uploaded.

Declaration
public uint RemainingUploadFileCount { get; }
Property Value
Type Description
System.UInt32

how many attachments are yet to be uploaded.

RemoteContactDirectories

Gets the list of currently configured LDAP or CardDAV remote servers used by Linphone.MagicSearch.

Declaration
public IEnumerable<RemoteContactDirectory> RemoteContactDirectories { get; }
Property Value
Type Description
System.Collections.Generic.IEnumerable<RemoteContactDirectory>

the list of Linphone.RemoteContactDirectory currently configured, if any. @maybenil

RemoteRingbackTone

Get the ring back tone played to far end during incoming calls.

Declaration
public string RemoteRingbackTone { get; set; }
Property Value
Type Description
System.String

the path to the remote ring back tone to be played. @maybenil

RetransmissionOnNackEnabled

Gets whether the use RTCP NACK for reliability of video transmission is enabled or not.

Using RTCP NACK feedback is one of the available techniques to help mitigate the loss of video RTP packets. It gives good results when round trip time is low. It is disabled by default.

Declaration
public bool RetransmissionOnNackEnabled { get; set; }
Property Value
Type Description
System.Boolean

A boolean value telling whether NACK usage is enabled or not

Ring

Returns the path to the wav file used for ringing.

Declaration
public string Ring { get; set; }
Property Value
Type Description
System.String

The path to the wav file used for ringing. @maybenil

Ringback

Returns the path to the wav file used for ringing back.

Declaration
public string Ringback { get; set; }
Property Value
Type Description
System.String

The path to the wav file used for ringing back. @maybenil

RingDuringIncomingEarlyMedia

Tells whether the ring play is enabled during an incoming early media call.

Declaration
public bool RingDuringIncomingEarlyMedia { get; set; }
Property Value
Type Description
System.Boolean

RingerDevice

Gets the name of the currently assigned sound device for ringing.

Declaration
[Obsolete]
public string RingerDevice { get; set; }
Property Value
Type Description
System.String

The name of the currently assigned sound device for ringing. @maybenil
Remarks

Deprecated : 29/08/2025 Use a combination of Linphone.Core.ExtendedAudioDevices and Linphone.AudioDevice.UseForRinging instead.

RootCa

Gets the path to a file or folder containing the trusted root CAs (PEM format)

Declaration
public string RootCa { get; set; }
Property Value
Type Description
System.String

The path to a file or folder containing the trusted root CAs. @maybenil

RootCaData

Sets the trusted root CAs (PEM format)

Declaration
public string RootCaData { set; }
Property Value
Type Description
System.String

RtpBundleEnabled

Returns whether RTP bundle mode (also known as Media Multiplexing) is enabled.

See https://datatracker.ietf.org/doc/html/rfc8843 for more information. See https://datatracker.ietf.org/doc/html/rfc8843 for more information.

Declaration
public bool RtpBundleEnabled { get; set; }
Property Value
Type Description
System.Boolean

a boolean indicating the enablement of rtp bundle mode.

Sdp200AckEnabled

Media offer control param for SIP INVITE.

Declaration
public bool Sdp200AckEnabled { get; set; }
Property Value
Type Description
System.Boolean

true if INVITE has to be sent whitout SDP.

SelfViewEnabled

Tells whether video self view during call is enabled or not.

Declaration
[Obsolete]
public bool SelfViewEnabled { get; set; }
Property Value
Type Description
System.Boolean

A boolean value telling whether self view is enabled
Remarks

See : Linphone.Core.EnableSelfView() for details.

SenderNameHiddenInForwardMessageEnabled

Enables whether or not to hide sender name in forwarded message.

Declaration
public bool SenderNameHiddenInForwardMessageEnabled { set; }
Property Value
Type Description
System.Boolean

SendMessageAfterNotifyEnabled

Returns enablement of sending chat messages on group chats after receiving the NOTIFY full state.

Declaration
public bool SendMessageAfterNotifyEnabled { get; set; }
Property Value
Type Description
System.Boolean

true if the core waits for the NOTIFY full statet before sending messages to group chats, false otherwise.

SessionExpiresEnabled

Check if the Session Timers feature is enabled.

Declaration
public bool SessionExpiresEnabled { get; set; }
Property Value
Type Description
System.Boolean

true if session timers are enabled, false otherwise

SessionExpiresMinValue

Returns the session expires min value, 90 by default.

Declaration
public int SessionExpiresMinValue { get; set; }
Property Value
Type Description
System.Int32

The minSE value

SessionExpiresRefresherValue

Returns the session expires refresher value.

Declaration
public SessionExpiresRefresher SessionExpiresRefresherValue { get; set; }
Property Value
Type Description
SessionExpiresRefresher

The Linphone.SessionExpiresRefresher configuration refresher value

SessionExpiresValue

Returns the session expires value.

Declaration
public int SessionExpiresValue { get; set; }
Property Value
Type Description
System.Int32

The session timer expire value

SipDscp

Gets the DSCP field for SIP signaling channel.

The DSCP defines the quality of service in IP packets.

Declaration
public int SipDscp { get; set; }
Property Value
Type Description
System.Int32

The current DSCP value

SipNetworkReachable

This method is called by the application to notify the linphone core library when the SIP network is reachable.

This is for advanced usage, when SIP and RTP layers are required to use different interfaces. Most applications just need Linphone.Core.NetworkReachable.

Declaration
public bool SipNetworkReachable { set; }
Property Value
Type Description
System.Boolean

SipTransportTimeout

Gets the SIP transport timeout, which represents the maximum time permitted to establish a connection to a SIP server.

Declaration
public int SipTransportTimeout { get; set; }
Property Value
Type Description
System.Int32

The SIP transport timeout in milliseconds.

SoundDevicesList

Gets the list of the available sound devices.

Declaration
[Obsolete]
public IEnumerable<string> SoundDevicesList { get; }
Property Value
Type Description
System.Collections.Generic.IEnumerable<System.String>

An unmodifiable array of strings contanining the names of the available sound devices that is null terminated. @maybenil
Remarks

Deprecated : 10/04/2021 Use Linphone.Core.AudioDevices instead.

SrtpCryptoSuites

Gets the crypto suites available to the core.

Declaration
public string SrtpCryptoSuites { get; set; }
Property Value
Type Description
System.String

a comma separated list of supported suites @notnil

StaticPicture

Get the path to the image file streamed when "Static picture" is set as the video device.

Declaration
public string StaticPicture { get; set; }
Property Value
Type Description
System.String

The path to the image file streamed when "Static picture" is set as the video device. @maybenil

StaticPictureFps

Get the frame rate for static picture.

Declaration
public float StaticPictureFps { get; set; }
Property Value
Type Description
System.Single

The frame rate used for static picture.

StunServer

Get the STUN server address being used.

Declaration
[Obsolete]
public string StunServer { get; set; }
Property Value
Type Description
System.String

The STUN server address being used. @maybenil
Remarks

Deprecated : 04/09/2024 use Linphone.Core.NatPolicy or Linphone.AccountParams.NatPolicy.

SupportedFileFormatsList

Returns a list of strings containing the file format types supported for call recording.

Declaration
public IEnumerable<string> SupportedFileFormatsList { get; }
Property Value
Type Description
System.Collections.Generic.IEnumerable<System.String>

The supported formats, typically 'wav', 'mka', 'mkv', 'smff'. @notnil

SupportedTag

Set the SIP supported tags.

Declaration
public string SupportedTag { set; }
Property Value
Type Description
System.String

Tag100RelSupportLevel

Gets the support level of the 100rel attribute.

Declaration
public SupportLevel Tag100RelSupportLevel { get; set; }
Property Value
Type Description
SupportLevel

The 100 rel support level

TcapLineMergingEnabled

Defines whether tcap lines are going to be merged if capability negotiation (RFC5939) is supported.

Declaration
public bool TcapLineMergingEnabled { set; }
Property Value
Type Description
System.Boolean

TcapLinesMergingEnabled

Checks if tcap lines are going to the merged if the capability negotiation (RFC5939) is supported or not.

Declaration
public bool TcapLinesMergingEnabled { get; }
Property Value
Type Description
System.Boolean

true if tcap lines with consecutive indexes are going to be merged; false otherwise.

TextPayloadTypes

Returns the list of the available real-time text payload types.

Declaration
public IEnumerable<PayloadType> TextPayloadTypes { get; set; }
Property Value
Type Description
System.Collections.Generic.IEnumerable<PayloadType>

A freshly allocated list of the available payload types. @maybenil

TextPort

Gets the UDP port used for text streaming.

Declaration
public int TextPort { get; set; }
Property Value
Type Description
System.Int32

The UDP port used for text streaming

TextPortsRange

Get the text port range from which is randomly chosen the UDP port used for text streaming.

Declaration
public Range TextPortsRange { get; }
Property Value
Type Description
Range

a Linphone.Range object @notnil

TlsCert

Gets the TLS certificate.

Declaration
public string TlsCert { get; set; }
Property Value
Type Description
System.String

the TLS certificate or null if not set yet. @maybenil

TlsCertPath

Gets the path to the TLS certificate file.

Declaration
public string TlsCertPath { get; set; }
Property Value
Type Description
System.String

the TLS certificate path or null if not set yet. @maybenil

TlsKey

Gets the TLS key.

Declaration
public string TlsKey { get; set; }
Property Value
Type Description
System.String

the TLS key or null if not set yet. @maybenil

TlsKeyPath

Gets the path to the TLS key file.

Declaration
public string TlsKeyPath { get; set; }
Property Value
Type Description
System.String

the TLS key path or null if not set yet. @maybenil

Transports

Retrieves the port configuration used for each transport (udp, tcp, tls).

A zero value port for a given transport means the transport is not used. A value of LC_SIP_TRANSPORT_RANDOM (-1) means the port is to be chosen randomly by the system. A value of LC_SIP_TRANSPORT_DONTBIND (-2) means that the socket will not be bound explicitely, in other words liblinphone won't listen for incoming connections at all. This mode is suitable for a pure client application (ex: a mobile application).

Declaration
public Transports Transports { get; set; }
Property Value
Type Description
Transports

A Linphone.Transports structure with the configured ports @notnil

TransportsUsed

Retrieves the real port number assigned for each sip transport (udp, tcp, tls).

A zero value means that the transport is not activated. If LC_SIP_TRANSPORT_RANDOM was passed to linphone_core_set_sip_transports, the random port choosed by the system is returned.

Declaration
public Transports TransportsUsed { get; }
Property Value
Type Description
Transports

A Linphone.Transports structure with the ports being used @notnil

Tunnel

Gets tunnel instance if available.

Declaration
public Tunnel Tunnel { get; }
Property Value
Type Description
Tunnel

Linphone.Tunnel or null if not available. @maybenil

UnreadChatMessageCount

Returns the global unread chat message count.

Declaration
public int UnreadChatMessageCount { get; }
Property Value
Type Description
System.Int32

The global unread chat message count.

UnreadChatMessageCountFromActiveLocals

Returns the unread chat message count for all active local address.

(Primary contact + proxy configs.)

Declaration
public int UnreadChatMessageCountFromActiveLocals { get; }
Property Value
Type Description
System.Int32

The unread chat message count.

UploadBandwidth

Retrieve the maximum available upload bandwidth.

This value was set by Linphone.Core.UploadBandwidth.

Declaration
public int UploadBandwidth { get; set; }
Property Value
Type Description
System.Int32

the upload bandiwdth in kbits/s, 0 for unknown.

UploadPtime

Gets audio packetization time linphone will send (in absence of requirement from peer) A value of 0 stands for the current codec default packetization time.

Declaration
public int UploadPtime { get; set; }
Property Value
Type Description
System.Int32

the upload packetization time set

UpnpExternalIpaddress

Return the external ip address of router.

In some cases the uPnP can have an external ip address but not a usable uPnP (state different of Ok).

Declaration
public string UpnpExternalIpaddress { get; }
Property Value
Type Description
System.String

a null terminated string containing the external ip address. If the the external ip address is not available return null. @maybenil

UpnpState

Return the internal state of uPnP.

Declaration
public UpnpState UpnpState { get; }
Property Value
Type Description
UpnpState

an LinphoneUpnpState.

UseFiles

Gets whether linphone is currently streaming audio from and to files, rather than using the soundcard.

Declaration
public bool UseFiles { get; set; }
Property Value
Type Description
System.Boolean

A boolean value representing whether linphone is streaming audio from and to files or not.

UseInfoForDtmf

Indicates whether SIP INFO can be used to send digits.

Declaration
public bool UseInfoForDtmf { get; set; }
Property Value
Type Description
System.Boolean

A boolean value telling whether SIP INFO is used to send digits

UserAgent

Gets the user-agent as a string.

Declaration
public string UserAgent { get; }
Property Value
Type Description
System.String

liblinphone's user agent as a string. @notnil

UserCertificatesPath

Get the path to the directory storing the user's certificates.

Declaration
public string UserCertificatesPath { get; set; }
Property Value
Type Description
System.String

The path to the directory storing the user's certificates. @maybenil

UseRfc2833ForDtmf

Indicates whether RFC2833/RFC4633 can be used to send digits.

Declaration
public bool UseRfc2833ForDtmf { get; set; }
Property Value
Type Description
System.Boolean

A boolean value telling whether RFC2833 is used to send digits

Version

Returns liblinphone's version as a string.

Declaration
public static string Version { get; }
Property Value
Type Description
System.String

the current version of the Linphone.Core @notnil

VibrationOnIncomingCallEnabled

Gets whether the device will vibrate while an incoming call is ringing (Android only).

Declaration
public bool VibrationOnIncomingCallEnabled { get; set; }
Property Value
Type Description
System.Boolean

true if the device will vibrate (if possible), false otherwise

VideoActivationPolicy

Get the default policy for video.

See Linphone.Core.VideoActivationPolicy for more details.

Declaration
public VideoActivationPolicy VideoActivationPolicy { get; set; }
Property Value
Type Description
VideoActivationPolicy

The currently used video policy @notnil

VideoAdaptiveJittcompEnabled

Tells whether the video adaptive jitter compensation is enabled.

Declaration
public bool VideoAdaptiveJittcompEnabled { get; set; }
Property Value
Type Description
System.Boolean

true if the video adaptive jitter compensation is enabled, false otherwise.

VideoCaptureEnabled

Tells whether video capture is enabled.

Declaration
public bool VideoCaptureEnabled { get; set; }
Property Value
Type Description
System.Boolean

true if video capture is enabled, false if disabled.

VideoCodecPriorityPolicy

Gets the current priority policy for video codecs (payload types).

See Linphone.CodecPriorityPolicy for more details.

Declaration
public CodecPriorityPolicy VideoCodecPriorityPolicy { get; set; }
Property Value
Type Description
CodecPriorityPolicy

the current Linphone.CodecPriorityPolicy

VideoDevice

Returns the name of the currently active video device.

Declaration
public string VideoDevice { get; set; }
Property Value
Type Description
System.String

The name of the currently active video device. @maybenil

VideoDevicesList

Gets the list of the available video capture devices.

Declaration
public IEnumerable<string> VideoDevicesList { get; }
Property Value
Type Description
System.Collections.Generic.IEnumerable<System.String>

An unmodifiable array of strings contanining the names of the available video capture devices that is null terminated. @maybenil

VideoDisplayEnabled

Tells whether video display is enabled.

Declaration
public bool VideoDisplayEnabled { get; set; }
Property Value
Type Description
System.Boolean

true if video display is enabled, false if disabled.

VideoDisplayFilter

Gets the name of the mediastreamer2 engine (filter) used for rendering video.

Declaration
public string VideoDisplayFilter { get; set; }
Property Value
Type Description
System.String

The currently selected video display filter. @maybenil

VideoDscp

Gets the DSCP field for outgoing video streams.

The DSCP defines the quality of service in IP packets.

Declaration
public int VideoDscp { get; set; }
Property Value
Type Description
System.Int32

The current DSCP value

VideoEnabled

Returns true if either capture or display is enabled, false otherwise.

same as ( Linphone.Core.VideoCaptureEnabled() | Linphone.Core.VideoDisplayEnabled() )

Declaration
public bool VideoEnabled { get; }
Property Value
Type Description
System.Boolean

true if either capture or display is enabled, false otherwise.

VideoJittcomp

Returns the nominal video jitter buffer size in milliseconds.

Declaration
public int VideoJittcomp { get; set; }
Property Value
Type Description
System.Int32

The nominal video jitter buffer size in milliseconds

VideoMulticastAddr

Use to get multicast address to be used for video stream.

Declaration
public string VideoMulticastAddr { get; set; }
Property Value
Type Description
System.String

an ipv4/6 multicast address, or default value. @maybenil

VideoMulticastEnabled

Use to get multicast state of video stream.

Declaration
public bool VideoMulticastEnabled { get; set; }
Property Value
Type Description
System.Boolean

true if subsequent calls will propose multicast ip set by Linphone.Core.VideoMulticastAddr

VideoMulticastTtl

Use to get multicast ttl to be used for video stream.

Declaration
public int VideoMulticastTtl { get; set; }
Property Value
Type Description
System.Int32

a time to leave value

VideoPayloadTypes

Returns the list of the available video payload types (codecs), in their order of preference.

Declaration
public IEnumerable<PayloadType> VideoPayloadTypes { get; set; }
Property Value
Type Description
System.Collections.Generic.IEnumerable<PayloadType>

A freshly allocated list of the available payload types. @maybenil

VideoPort

Gets the UDP port used for video streaming.

Declaration
public int VideoPort { get; set; }
Property Value
Type Description
System.Int32

The UDP port used for video streaming

VideoPortsRange

Get the video port range from which is randomly chosen the UDP port used for video streaming.

Declaration
public Range VideoPortsRange { get; }
Property Value
Type Description
Range

a Linphone.Range object @notnil

VideoPreset

Get the video preset used for video calls.

Declaration
public string VideoPreset { get; set; }
Property Value
Type Description
System.String

The name of the video preset used for video calls (can be null if the default video preset is used). @maybenil

VideoPreviewEnabled

Tells whether video preview is enabled.

Declaration
public bool VideoPreviewEnabled { get; set; }
Property Value
Type Description
System.Boolean

A boolean value telling whether video preview is enabled

VideoSourceReuseEnabled

Enable or disable video source reuse when switching from preview to actual video call.

This source reuse is useful when you always display the preview, even before calls are initiated. By keeping the video source for the transition to a real video call, you will smooth out the source close/reopen cycle. This function does not have any effect during calls. It just indicates the Linphone.Core to initiate future calls with video source reuse or not. Also, at the end of a video call, the source will be closed whatsoever for now.

Declaration
public bool VideoSourceReuseEnabled { set; }
Property Value
Type Description
System.Boolean

WifiOnlyEnabled

Tells whether Wifi only mode is enabled or not.

Declaration
public bool WifiOnlyEnabled { get; set; }
Property Value
Type Description
System.Boolean

A boolean value telling whether Wifi only mode is enabled or not
Remarks

Warning : Only works for Android platform.

ZeroRtpPortForStreamInactiveEnabled

Checks if RTP port is set to 0 when a stream is inactive.

Declaration
public bool ZeroRtpPortForStreamInactiveEnabled { get; set; }
Property Value
Type Description
System.Boolean

true if the RTP port is set to 0 if the stream direction is inactive; false otherwise.

ZrtpCacheDb

Get a pointer to the sqlite db holding zrtp/lime cache.

Declaration
public IntPtr ZrtpCacheDb { get; }
Property Value
Type Description
System.IntPtr

An sqlite3 pointer cast to a void one or null if cache is not available(not enabled at compile or access failed) @maybenil

ZrtpGoClearEnabled

Checks if the ZRTP go clear is enabled or not.

Declaration
public bool ZrtpGoClearEnabled { get; set; }
Property Value
Type Description
System.Boolean

true if ZTRP go clear is enabled; false otherwise.

ZrtpSecretsFile

Gets the path to the file storing the zrtp secrets cache.

Declaration
public string ZrtpSecretsFile { get; set; }
Property Value
Type Description
System.String

The path to the file storing the zrtp secrets cache. @maybenil

Methods

AbortAuthentication(AuthInfo)

This method is used to abort a user authentication request initiated by Linphone.Core from the authentication_requested callback of Linphone.CoreListener.

Declaration
public void AbortAuthentication(AuthInfo info)
Parameters
Type Name Description
AuthInfo info

the Linphone.AuthInfo for which to abort authentication @maybenil
Remarks

Note : this function currently does not take into account the 'info' parameter. All pending authentication requests are aborted.

ActivateAudioSession(Boolean)

Special function to indicate if the audio session is activated.

Must be called when ProviderDelegate of the callkit notifies that the audio session is activated or deactivated.

Declaration
public void ActivateAudioSession(bool activated)
Parameters
Type Name Description
System.Boolean activated

true to activate the audio session, false to disable it.

AddAccount(Account)

Adds an account.

This will start registration on the proxy, if registration is enabled.

Declaration
public void AddAccount(Account account)
Parameters
Type Name Description
Account account

the Linphone.Account to add @notnil

AddAllToConference()

Adds all calls into the conference.

If no conference is running a new internal conference context is created and all current calls are added to it.

Declaration
[Obsolete]
public void AddAllToConference()
Remarks

Warning : This function guarantees that the local endpoint is added to the conference.

AddAuthInfo(AuthInfo)

Adds authentication information to the Linphone.Core.

These nformation will be used during all SIP or HTTP transactions that require authentication.

Declaration
public void AddAuthInfo(AuthInfo info)
Parameters
Type Name Description
AuthInfo info

The Linphone.AuthInfo to add. @notnil

AddContentTypeSupport(String)

Add support for the specified content type.

It is the application responsibility to handle it correctly afterwards.

Declaration
public void AddContentTypeSupport(string contentType)
Parameters
Type Name Description
System.String contentType

The content type to add support for @notnil

AddFriendList(FriendList)

Add a friend list.

Declaration
public void AddFriendList(FriendList list)
Parameters
Type Name Description
FriendList list

Linphone.FriendList object @notnil

AddLdap(Ldap)

Add or update a LDAP server and save it to the configuration.

Declaration
[Obsolete]
public void AddLdap(Ldap ldap)
Parameters
Type Name Description
Ldap ldap

The Linphone.Ldap object to add/update. @notnil
Remarks

Deprecated : 18/11/2024 use Linphone.Core.AddRemoteContactDirectory() instead.

AddLinphoneSpec(String)

Add the given linphone specs to the list of functionalities the linphone client supports.

Declaration
public void AddLinphoneSpec(string spec)
Parameters
Type Name Description
System.String spec

The spec to add @notnil
Remarks

See : Linphone.Core.LinphoneSpecsList

AddProvisioningHeader(String, String)

Add an extra header for retrieving the remote provisioning (check Linphone.Core.ProvisioningUri).

This can also be set from configuration file or factory config file, from[misc] section, item "config-uri-headers_X" where X is the index of the header starting by 0.

Declaration
public void AddProvisioningHeader(string headerName, string val)
Parameters
Type Name Description
System.String headerName

the header to use when downloading the configuration. @notnil
System.String val

the value to use when downloading the configuration. @notnil

AddProxyConfig(ProxyConfig)

Add a proxy configuration.

This will start registration on the proxy, if registration is enabled.

Declaration
[Obsolete]
public void AddProxyConfig(ProxyConfig config)
Parameters
Type Name Description
ProxyConfig config

the Linphone.ProxyConfig to add @notnil
Remarks

Deprecated : 04/09/2024 Use Linphone.Core.AddAccount()

AddRemoteContactDirectory(RemoteContactDirectory)

Adds a Linphone.RemoteContactDirectory object previously created to the Core, to be used later by Linphone.MagicSearch to query contacts using either LDAP or CardDAV.

Declaration
public void AddRemoteContactDirectory(RemoteContactDirectory remoteContactDirectory)
Parameters
Type Name Description
RemoteContactDirectory remoteContactDirectory

the newly created Linphone.RemoteContactDirectory to add. @notnil

AddSupportedTag(String)

This function controls signaling features supported by the core.

They are typically included in a SIP Supported header.

Declaration
public void AddSupportedTag(string tag)
Parameters
Type Name Description
System.String tag

The feature tag name @notnil

AddToConference(Call)

Adds a participant to the conference.

If no conference is going on a new internal conference context is created and the participant is added to it.

Declaration
[Obsolete]
public void AddToConference(Call call)
Parameters
Type Name Description
Call call

The current call with the participant to add @notnil
Remarks

Deprecated : 23/01/2025 Use Linphone.Conference.AddParticipant() instead.

AudioRouteChanged()

Special function to indicate if the audio route is changed.

Must be called in the callback of AVAudioSessionRouteChangeNotification.

Declaration
[Obsolete]
public void AudioRouteChanged()
Remarks

Deprecated : 07/01/2020 now handled in the linphone SDK directly

CallRingingDisabled()

Check whether ringing of calls is disabled.

Declaration
public bool CallRingingDisabled()
Returns
Type Description
System.Boolean

true if call ringing is disabled

ChatRoomGetDefaultEphemeralMode()

Gets the default ephemeral message mode.

Declaration
[Obsolete]
public ChatRoomEphemeralMode ChatRoomGetDefaultEphemeralMode()
Returns
Type Description
ChatRoomEphemeralMode

the default ephemeral message mode Linphone.ChatRoomEphemeralMode
Remarks

Deprecated : 21/11/2025 use Linphone.Core.DefaultEphemeralMode.

ChatRoomSetDefaultEphemeralMode(ChatRoomEphemeralMode)

Sets the default ephemeral message mode.

Declaration
[Obsolete]
public void ChatRoomSetDefaultEphemeralMode(ChatRoomEphemeralMode mode)
Parameters
Type Name Description
ChatRoomEphemeralMode mode

default ephemeral message mode Linphone.ChatRoomEphemeralMode
Remarks

Deprecated : 21/11/2025 use Linphone.Core.DefaultEphemeralMode.

CheckForUpdate(String)

Asynchronously checks if a new version of the application is available from a well-known http server URI given by Linphone.Core 's configuration.

The result of the check is given through the Linphone.CoreListener interface, see linphone_core_cbs_set_version_update_check_result_received. The http URI has to be given in [misc] section as key 'version_check_url_root'. The subdirectory is appended to this root URI, per platform, and a "VERSION" file is fetched. For example: -https://download.linphone.org/releases/android/RELEASE -https://download.linphone.org/releases/windows/RELEASE The RELEASE file is expected to contain the most recent version number available followed by an http uri where this version can be retrieved. For example: 5.2.5 https://play.google.com/store/apps/details?id=org.linphone

Declaration
public void CheckForUpdate(string currentVersion)
Parameters
Type Name Description
System.String currentVersion

ClearAccounts()

Erases all accounts from config.

Declaration
public void ClearAccounts()

ClearAllAuthInfo()

Clears all authentication information.

Declaration
public void ClearAllAuthInfo()

ClearCallLogs()

Erases the call log list.

Declaration
public void ClearCallLogs()

ClearLdaps()

Erases all LDAP from the configuration.

Declaration
[Obsolete]
public void ClearLdaps()
Remarks

Deprecated : 18/11/2024 use Linphone.Core.RemoveRemoteContactDirectory() instead.

ClearProvisioningHeaders()

Clear all headers that were added with Linphone.Core.AddProvisioningHeader().

Declaration
public void ClearProvisioningHeaders()

ClearProxyConfig()

Erase all proxies from config.

Declaration
[Obsolete]
public void ClearProxyConfig()
Remarks

Deprecated : 04/09/2024 Use Linphone.Core.ClearAccounts()

CompressLogCollection()

Compresses the log collection in a single file.

Declaration
public static string CompressLogCollection()
Returns
Type Description
System.String

The path of the compressed log collection file. @notnil

ConfigSync()

Forces a flush of the config to disk.

Declaration
public void ConfigSync()

ConfigureAudioSession()

Special function to configure audio session with default settings.

Must be called in ProviderDelegate's callbacks when answer an incoming call and start an outgoing call.

Declaration
public void ConfigureAudioSession()

CreateAccount(AccountParams)

Creates an account using given parameters, see Linphone.Core.CreateAccountParams().

Once created, the account must be added to the Linphone.Core in order to be used for registration, calls, messages etc. Use Linphone.Core.AddAccount() to add it to the Linphone.Core.

Declaration
public Account CreateAccount(AccountParams parameters)
Parameters
Type Name Description
AccountParams parameters

Linphone.AccountParams object @notnil
Returns
Type Description
Account

Linphone.Account with default values set @notnil

CreateAccountCreator(String)

Create a Linphone.AccountCreator and set Linphone Request callbacks.

Declaration
[Obsolete]
public AccountCreator CreateAccountCreator(string xmlrpcUrl)
Parameters
Type Name Description
System.String xmlrpcUrl

The URL to the XML-RPC server. @maybenil
Returns
Type Description
AccountCreator

The new Linphone.AccountCreator object. @notnil
Remarks

Deprecated : 04/09/2024 : The Linphone.AccountCreator interface is replaced by the Linphone.AccountManagerServices interface.

CreateAccountManagerServices()

Creates a Linphone.AccountManagerServices.

Declaration
public AccountManagerServices CreateAccountManagerServices()
Returns
Type Description
AccountManagerServices

The new Linphone.AccountManagerServices object. @notnil

CreateAccountParams()

Create an account params using default values from Linphone core.

Declaration
public AccountParams CreateAccountParams()
Returns
Type Description
AccountParams

Linphone.AccountParams with default values set @notnil

CreateAddress(String)

Creates a Linphone.Address object by parsing the user supplied address, given as a string.

Declaration
[Obsolete]
public Address CreateAddress(string address)
Parameters
Type Name Description
System.String address

String containing the user supplied address @maybenil
Returns
Type Description
Address

The created Linphone.Address object @maybenil
Remarks

Deprecated : 04/06/2024 use Linphone.Factory.CreateAddress().

CreateCallLog(Address, Address, CallDir, Int32, Int64, Int64, CallStatus, Boolean, Single)

Creates a fake Linphone.CallLog.

Declaration
public CallLog CreateCallLog(Address from, Address to, CallDir dir, int duration, long startTime, long connectedTime, CallStatus status, bool videoEnabled, float quality)
Parameters
Type Name Description
Address from

Linphone.Address of caller @notnil
Address to

Linphone.Address of callee @notnil
CallDir dir

Linphone.CallDir of call
System.Int32 duration

call length in seconds
System.Int64 startTime

timestamp of call start time
System.Int64 connectedTime

timestamp of call connection
CallStatus status

Linphone.CallStatus of call
System.Boolean videoEnabled

whether video was enabled or not for this call
System.Single quality

call quality
Returns
Type Description
CallLog

a Linphone.CallLog object @notnil

CreateCallParams(Call)

Creates a Linphone.CallParams suitable for Linphone.Core.InviteWithParams(), Linphone.Call.AcceptWithParams(), Linphone.Call.AcceptEarlyMediaWithParams(), Linphone.Call.Update() or linphone_call_accept_update_with_params().

The parameters are initialized according to the current Linphone.Core configuration and the current state of the call if any. In order to create a Linphone.CallParams for an already created call, the call argument must not be null.

Declaration
public CallParams CreateCallParams(Call call)
Parameters
Type Name Description
Call call

Linphone.Call for which the parameters are to be built, or null in the case where the parameters are to be used for a new outgoing call. @maybenil
Returns
Type Description
CallParams

A new Linphone.CallParams object. @maybenil

CreateCardDavParams()

Creates a new CardDAV server params object that may be used later by Linphone.MagicSearch to query contacts.

Declaration
public CardDavParams CreateCardDavParams()
Returns
Type Description
CardDavParams

a new Linphone.CardDavParams object to configure, and then use it to create a Linphone.RemoteContactDirectory using Linphone.Core.CreateCardDavRemoteContactDirectory(). @notnil

CreateCardDavRemoteContactDirectory(CardDavParams)

Creates a new CardDAV server params object that may be used later by Linphone.MagicSearch to query contacts.

Declaration
public RemoteContactDirectory CreateCardDavRemoteContactDirectory(CardDavParams parameters)
Parameters
Type Name Description
CardDavParams parameters

the Linphone.CardDavParams to configure this remote contact directory. @notnil
Returns
Type Description
RemoteContactDirectory

a new Linphone.RemoteContactDirectory object to configure, and then add using Linphone.Core.AddRemoteContactDirectory(). @notnil

CreateCcmpConferenceScheduler(Account)

Create a SIP conference scheduler that can be used to create client conferences for now or later and then send conference info as an ICS through chat.

A CCMPConferenceScheduler creates a conference on a server by using the CCMP protocol

Declaration
public ConferenceScheduler CreateCcmpConferenceScheduler(Account account)
Parameters
Type Name Description
Account account

The Linphone.Account to use in the Linphone.ConferenceScheduler. @maybenil
Returns
Type Description
ConferenceScheduler

A pointer on the freshly created Linphone.ConferenceScheduler. @notnil

CreateChatRoom(Address)

Declaration
[Obsolete]
public ChatRoom CreateChatRoom(Address participant)
Parameters
Type Name Description
Address participant

Linphone.Address representing the initial participant to add to the chat room @notnil
Returns
Type Description
ChatRoom

The newly created chat room. @maybenil
Remarks

Deprecated : 02/07/2020, use Linphone.Core.CreateChatRoom() instead

CreateChatRoom(ChatRoomParams, Address, Address)

Declaration
[Obsolete]
public ChatRoom CreateChatRoom(ChatRoomParams parameters, Address localAddr, Address participant)
Parameters
Type Name Description
ChatRoomParams parameters

The chat room creation parameters Linphone.ChatRoomParams @notnil
Address localAddr

Linphone.Address representing the local proxy configuration to use for the chat room creation @notnil
Address participant

Linphone.Address representing the initial participant to add to the chat room @notnil
Returns
Type Description
ChatRoom

The newly created chat room. @maybenil
Remarks

Deprecated : 02/07/2020, use Linphone.Core.CreateChatRoom() instead

CreateChatRoom(ChatRoomParams, Address, IEnumerable<Address>)

Create a chat room.

Declaration
[Obsolete]
public ChatRoom CreateChatRoom(ChatRoomParams parameters, Address localAddr, IEnumerable<Address> participants)
Parameters
Type Name Description
ChatRoomParams parameters

The chat room creation parameters Linphone.ChatRoomParams @notnil
Address localAddr

Linphone.Address of a local Linphone.Account identity or null @maybenil
System.Collections.Generic.IEnumerable<Address> participants

The initial list of participants of the chat room. @notnil
Returns
Type Description
ChatRoom

The newly created chat room (can be an existing one if backend is Basic) or null. @maybenil
Remarks

Deprecated : 22/10/2024, use Linphone.Core.CreateChatRoom() instead

CreateChatRoom(ChatRoomParams, Address, String, IEnumerable<Address>)

Create a chat room.

Declaration
[Obsolete]
public ChatRoom CreateChatRoom(ChatRoomParams parameters, Address localAddr, string subject, IEnumerable<Address> participants)
Parameters
Type Name Description
ChatRoomParams parameters

The chat room creation parameters Linphone.ChatRoomParams @notnil
Address localAddr

Linphone.Address representing the local proxy configuration to use for the chat room creation @notnil
System.String subject

The subject of the group chat room @notnil
System.Collections.Generic.IEnumerable<Address> participants

The initial list of participants of the chat room @notnil
Returns
Type Description
ChatRoom

The newly created chat room. @maybenil
Remarks

Deprecated : 02/07/2020, use Linphone.Core.CreateChatRoom() instead

CreateChatRoom(ChatRoomParams, String, IEnumerable<Address>)

Create a chat room.

Declaration
[Obsolete]
public ChatRoom CreateChatRoom(ChatRoomParams parameters, string subject, IEnumerable<Address> participants)
Parameters
Type Name Description
ChatRoomParams parameters

The chat room creation parameters Linphone.ChatRoomParams @notnil
System.String subject

The subject of the group chat room @notnil
System.Collections.Generic.IEnumerable<Address> participants

The initial list of participants of the chat room. @notnil
Returns
Type Description
ChatRoom

The newly created chat room. @maybenil
Remarks

Deprecated : 02/07/2020, use Linphone.Core.CreateChatRoom() instead

CreateChatRoom(ConferenceParams, IEnumerable<Address>)

Create a chat room.

Declaration
public ChatRoom CreateChatRoom(ConferenceParams parameters, IEnumerable<Address> participants)
Parameters
Type Name Description
ConferenceParams parameters

The chat room creation parameters Linphone.ConferenceParams @notnil
System.Collections.Generic.IEnumerable<Address> participants

The initial list of participants of the chat room. @notnil
Returns
Type Description
ChatRoom

The newly created chat room (can be an existing one if backend is Basic) or null. @maybenil

CreateChatRoom(String, IEnumerable<Address>)

Declaration
[Obsolete]
public ChatRoom CreateChatRoom(string subject, IEnumerable<Address> participants)
Parameters
Type Name Description
System.String subject

The subject of the group chat room @notnil
System.Collections.Generic.IEnumerable<Address> participants

The initial list of participants of the chat room. @notnil
Returns
Type Description
ChatRoom

The newly created chat room. @maybenil
Remarks

Deprecated : 02/07/2020, use Linphone.Core.CreateChatRoom() instead

CreateClientGroupChatRoom(String, Boolean)

Create a client-side group chat room.

When calling this function the chat room is only created at the client-side and is empty. You need to call Linphone.ChatRoom.AddParticipants() to create at the server side and add participants to it. Also, the created chat room will not be a one-on-one chat room even if Linphone.ChatRoom.AddParticipants() is called with only one participant.

Declaration
[Obsolete]
public ChatRoom CreateClientGroupChatRoom(string subject, bool fallback)
Parameters
Type Name Description
System.String subject

The subject of the group chat room @notnil
System.Boolean fallback

Boolean value telling whether we should plan on being able to fallback to a basic chat room if the client-side group chat room creation fails
Returns
Type Description
ChatRoom

The newly created client-side group chat room. @maybenil
Remarks

Deprecated : 02/07/2020, use Linphone.Core.CreateChatRoom() instead

CreateClientGroupChatRoom(String, Boolean, Boolean)

Create a client-side group chat room.

When calling this function the chat room is only created at the client-side and is empty. You need to call Linphone.ChatRoom.AddParticipants() to create at the server side and add participants to it. Also, the created chat room will not be a one-on-one chat room even if Linphone.ChatRoom.AddParticipants() is called with only one participant.

Declaration
[Obsolete]
public ChatRoom CreateClientGroupChatRoom(string subject, bool fallback, bool encrypted)
Parameters
Type Name Description
System.String subject

The subject of the group chat room @notnil
System.Boolean fallback

Boolean value telling whether we should plan on being able to fallback to a basic chat room if the client-side group chat room creation fails
System.Boolean encrypted

Boolean value telling whether we should apply encryption or not on chat messages sent and received on this room.
Returns
Type Description
ChatRoom

The newly created client-side group chat room. @maybenil
Remarks

Deprecated : 02/07/2020, use Linphone.Core.CreateChatRoom() instead

CreateConferenceParams(Conference)

Creates some default conference parameters for instanciating a conference with Linphone.Core.CreateConferenceWithParams().

Declaration
public ConferenceParams CreateConferenceParams(Conference conference)
Parameters
Type Name Description
Conference conference

Linphone.Conference for which the parameters are to be build, or null in the case where the parameters are to be used for a new conference. @maybenil
Returns
Type Description
ConferenceParams

a Linphone.ConferenceParams object. @notnil

CreateConferenceScheduler()

Create a conference scheduler that can be used to schedule conferences on a client conference service and then send conference information invitation as an ICS object through chat.

The default account (see Linphone.Core.DefaultAccount ) is used to determine which kind of conference scheduler is created.

Declaration
public ConferenceScheduler CreateConferenceScheduler()
Returns
Type Description
ConferenceScheduler

A pointer on the freshly created Linphone.ConferenceScheduler. @notnil

CreateConferenceScheduler(Account)

Create a conference scheduler that can be used to create client conferences for now or later and then send conference info as an ICS through chat.

A SIP-based implementation is created if the Linphone.Account has not defined the URL of a CCMP server, other it will create a implementation relying on CCMP protocol.

Declaration
public ConferenceScheduler CreateConferenceScheduler(Account account)
Parameters
Type Name Description
Account account

The Linphone.Account to use in the Linphone.ConferenceScheduler. @maybenil
Returns
Type Description
ConferenceScheduler

A pointer on the freshly created Linphone.ConferenceScheduler. @notnil

CreateConferenceSchedulerWithType(Account, ConferenceSchedulerType)

Create a conference scheduler that can be used to create client conferences for now or later and then send conference info as an ICS through chat by specifying its type.

Declaration
public ConferenceScheduler CreateConferenceSchedulerWithType(Account account, ConferenceSchedulerType schedulingType)
Parameters
Type Name Description
Account account

The Linphone.Account to use in the Linphone.ConferenceScheduler. @maybenil
ConferenceSchedulerType schedulingType

The type of the Linphone.ConferenceScheduler.
Returns
Type Description
ConferenceScheduler

A pointer on the freshly created Linphone.ConferenceScheduler. @notnil

CreateConferenceWithParams(ConferenceParams)

Create a conference.

Local or client conference is determinated from the 'conference_type' variable in the 'misc' section of the configuration, or by the factory address parameter. See Linphone.ConferenceParams.ConferenceFactoryAddress for more details.

Declaration
public Conference CreateConferenceWithParams(ConferenceParams parameters)
Parameters
Type Name Description
ConferenceParams parameters

Parameters of the conference. See Linphone.ConferenceParams. @notnil
Returns
Type Description
Conference

A pointer on the freshly created conference Linphone.Conference. That object will be automatically freed by the core after calling Linphone.Core.TerminateConference(). @maybenil
Remarks

Warning : To guarantee the backward comatibility, this method will assign the created conference to the conference context held by the core. Nonetheless starting from release 5.4, the conference context will be override at every conference created by calling this method

CreateConfig(String)

Create a Linphone.Config object from a user config file.

Declaration
public Config CreateConfig(string filename)
Parameters
Type Name Description
System.String filename

The filename of the config file to read to fill the instantiated Linphone.Config @maybenil
Returns
Type Description
Config

a Linphone.Config object. @notnil

CreateContent()

Creates a content with default values from Linphone core.

Declaration
public Content CreateContent()
Returns
Type Description
Content

Linphone.Content object with default values set @notnil

CreateDbConferenceScheduler(Account)

Create a database conference scheduler that can be used to create client conferences for now or later and then send conference info as an ICS through chat.

The DBConferenceScheduler only creates a conference info to be stored in the database of the linphone core

Declaration
public ConferenceScheduler CreateDbConferenceScheduler(Account account)
Parameters
Type Name Description
Account account

The Linphone.Account to use in the Linphone.ConferenceScheduler. @maybenil
Returns
Type Description
ConferenceScheduler

A pointer on the freshly created Linphone.ConferenceScheduler. @notnil

CreateDefaultChatRoomParams()

Creates and returns the default chat room parameters.

Declaration
public ChatRoomParams CreateDefaultChatRoomParams()
Returns
Type Description
ChatRoomParams

A Linphone.ChatRoomParams object @notnil

CreateEktInfoFromXml(String)

Gets a Linphone.EktInfo from an XML body.

Declaration
public EktInfo CreateEktInfoFromXml(string xmlBody)
Parameters
Type Name Description
System.String xmlBody

the string containing the XML body @notnil
Returns
Type Description
EktInfo

The Linphone.EktInfo @maybenil

CreateFriend()

Creates an empty LinphoneFriend.

Declaration
public Friend CreateFriend()
Returns
Type Description
Friend

The created Linphone.Friend object @notnil

CreateFriendFromVcard(Vcard)

Creates a Linphone.Friend from ai Linphone.Vcard.

Declaration
public Friend CreateFriendFromVcard(Vcard vcard)
Parameters
Type Name Description
Vcard vcard

a Linphone.Vcard object @notnil
Returns
Type Description
Friend

A new Linphone.Friend object which has its vCard attribute initialized from the given vCard, accessible using Linphone.Friend.Vcard. @maybenil

CreateFriendList()

Creates a new empty Linphone.FriendList object.

Declaration
public FriendList CreateFriendList()
Returns
Type Description
FriendList

A new Linphone.FriendList object. @notnil

CreateFriendWithAddress(String)

Creates a Linphone.Friend from the given address.

Declaration
public Friend CreateFriendWithAddress(string address)
Parameters
Type Name Description
System.String address

A string containing the address to create the Linphone.Friend from @notnil
Returns
Type Description
Friend

The created Linphone.Friend object. @maybenil

CreateInfoMessage()

Creates an empty info message.

Declaration
public InfoMessage CreateInfoMessage()
Returns
Type Description
InfoMessage

a new LinphoneInfoMessage. @notnil

CreateLdap()

Creates an empty LDAP search.

Linphone.Ldap.Params must be call to save the parameters in the configuration file.

Declaration
[Obsolete]
public Ldap CreateLdap()
Returns
Type Description
Ldap

Linphone.Ldap with default values set @notnil
Remarks

Deprecated : 18/11/2024 use Linphone.Core.CreateLdapRemoteContactDirectory() instead.

CreateLdapParams()

Create a LDAP params using default values from Linphone core.

Check Linphone.LdapParams to update values. In order to add a new LDAP configuration to Linphone.MagicSearch, these parameters must be passed to linphone_core_create_ldap_with_params. Or, use Linphone.Ldap.Params.

Declaration
public LdapParams CreateLdapParams()
Returns
Type Description
LdapParams

Linphone.LdapParams with default values set. @notnil

CreateLdapRemoteContactDirectory(LdapParams)

Creates a new CardDAV server params object that may be used later by Linphone.MagicSearch to query contacts.

Declaration
public RemoteContactDirectory CreateLdapRemoteContactDirectory(LdapParams parameters)
Parameters
Type Name Description
LdapParams parameters

the Linphone.LdapParams to configure this remote contact directory. @notnil
Returns
Type Description
RemoteContactDirectory

a new Linphone.RemoteContactDirectory object to configure, and then add using Linphone.Core.AddRemoteContactDirectory(). @notnil

CreateLdapWithParams(LdapParams)

Creates a LDAP search using given parameters, adds it to the core list and stores them in the configuration file.

Declaration
[Obsolete]
public Ldap CreateLdapWithParams(LdapParams parameters)
Parameters
Type Name Description
LdapParams parameters

Linphone.LdapParams object @notnil
Returns
Type Description
Ldap

Linphone.Ldap object @notnil
Remarks

Deprecated : 18/11/2024 use Linphone.Core.CreateLdapRemoteContactDirectory() instead.

CreateLocalPlayer(String, String, IntPtr)

Creates a media file player, that can be used to play audio and video to the user, outside of any call or conference.

See Linphone.Core.SupportedFileFormatsList for supported multimedia file types.

Declaration
public Player CreateLocalPlayer(string soundCardName, string videoDisplayName, IntPtr windowId)
Parameters
Type Name Description
System.String soundCardName

Playback sound card. If null, the ringer sound card set in Linphone.Core will be used @maybenil
System.String videoDisplayName

Video display. If null, the video display set in Linphone.Core will be used @maybenil
System.IntPtr windowId

Id of the drawing window. See linphone_core_set_native_video_window_id for a discussion about supported native video window types. @maybenil
Returns
Type Description
Player

A pointer on the new instance. null if failed. @maybenil

CreateMagicSearch()

Creates a Linphone.MagicSearch object.

Declaration
public MagicSearch CreateMagicSearch()
Returns
Type Description
MagicSearch

The created Linphone.MagicSearch object @notnil

CreateNativePreviewWindowId()

Create a native window handle for the video preview window.

see Linphone.Core.CreateNativePreviewWindowId() for details

Declaration
public IntPtr CreateNativePreviewWindowId()
Returns
Type Description
System.IntPtr

The native window handle of the video preview window. @maybenil

CreateNativePreviewWindowId(IntPtr)

Create a Window ID for the video preview window.

Available for MSQOGL and MSOGL. see linphone_core_set_native_video_window_id for details about window_id Available for MSQOGL and MSOGL. see linphone_core_set_native_video_window_id for details about window_id MSQOgl can be used for the creation. Linphone.Core.CreateNativePreviewWindowId() returns a QQuickFramebufferObject::Renderer. This object must be returned by your QQuickFramebufferObject::createRenderer() overload for Qt. linphone_core_set_native_preview_window_id_2() must be called with this object after the creation. Note : Qt blocks GUI thread when calling createRenderer(), so it is safe to call linphone functions there if needed. MSQOgl can be used for the creation. Linphone.Core.CreateNativePreviewWindowId() returns a QQuickFramebufferObject::Renderer. This object must be returned by your QQuickFramebufferObject::createRenderer() overload for Qt. linphone_core_set_native_preview_window_id_2() must be called with this object after the creation. Note : Qt blocks GUI thread when calling createRenderer(), so it is safe to call linphone functions there if needed. A context can be used to prevent Linphone from allocating the container (MSOglContextInfo for MSOGL). null if not used. A context can be used to prevent Linphone from allocating the container (MSOglContextInfo for MSOGL). null if not used.

Declaration
public IntPtr CreateNativePreviewWindowId(IntPtr context)
Parameters
Type Name Description
System.IntPtr context

preallocated Window ID (Used only for MSOGL) @maybenil
Returns
Type Description
System.IntPtr

The created Window ID. @maybenil

CreateNativeVideoWindowId()

Create a native window handle for the video window from the current call.

see Linphone.Core.CreateNativeVideoWindowId() for details

Declaration
public IntPtr CreateNativeVideoWindowId()
Returns
Type Description
System.IntPtr

The native window handle of the video window. @maybenil

CreateNativeVideoWindowId(IntPtr)

Create a Window ID from the current call.

Available for MSQOGL and MSOGL. see linphone_core_set_native_video_window_id for details about window_id Available for MSQOGL and MSOGL. see linphone_core_set_native_video_window_id for details about window_id When MSQOgl can be used for the creation: Linphone.Core.CreateNativeVideoWindowId() returns a QQuickFramebufferObject::Renderer. This object must be returned by your QQuickFramebufferObject::createRenderer() overload for Qt. linphone_core_set_native_video_window_id must be called with this object after the creation. Note : Qt blocks GUI thread when calling createRenderer(), so it is safe to call linphone functions there if needed. When MSQOgl can be used for the creation: Linphone.Core.CreateNativeVideoWindowId() returns a QQuickFramebufferObject::Renderer. This object must be returned by your QQuickFramebufferObject::createRenderer() overload for Qt. linphone_core_set_native_video_window_id must be called with this object after the creation. Note : Qt blocks GUI thread when calling createRenderer(), so it is safe to call linphone functions there if needed. A context can be used to prevent Linphone from allocating the container (MSOglContextInfo for MSOGL). null if not used. A context can be used to prevent Linphone from allocating the container (MSOglContextInfo for MSOGL). null if not used.

Declaration
public IntPtr CreateNativeVideoWindowId(IntPtr context)
Parameters
Type Name Description
System.IntPtr context

preallocated Window ID (Used only for MSOGL) @maybenil
Returns
Type Description
System.IntPtr

The created Window ID @maybenil

CreateNatPolicy()

Create a new Linphone.NatPolicy object with every policies being disabled.

Declaration
public NatPolicy CreateNatPolicy()
Returns
Type Description
NatPolicy

A new Linphone.NatPolicy object. @notnil

CreateNotify(Address, String)

Creates an out-of-dialog notification, specifying the destination resource, the event name.

The notification can be send with Linphone.Event.Notify().

Declaration
public Event CreateNotify(Address resource, string ev)
Parameters
Type Name Description
Address resource

the destination resource @notnil
System.String ev

the event name @notnil
Returns
Type Description
Event

a Linphone.Event holding the context of the notification. @notnil

CreateOneShotPublish(Address, String)

Creates a publish context for a one-shot publish.

After being created, the publish must be sent using Linphone.Event.SendPublish(). The Linphone.Event is automatically terminated when the publish transaction is finished, either with success or failure. The application must not call Linphone.Event.Terminate() for such one-shot publish.

Declaration
public Event CreateOneShotPublish(Address resource, string ev)
Parameters
Type Name Description
Address resource

the resource uri for the event @notnil
System.String ev

the event name @notnil
Returns
Type Description
Event

the Linphone.Event holding the context of the publish. @notnil

CreatePresenceActivity(PresenceActivityType, String)

Creates a Linphone.PresenceActivity with the given type and description.

Declaration
public PresenceActivity CreatePresenceActivity(PresenceActivityType acttype, string description)
Parameters
Type Name Description
PresenceActivityType acttype

The Linphone.PresenceActivityType to set for the activity.
System.String description

An additional description of the activity to set for the activity. Can be null if no additional description is to be added. @maybenil
Returns
Type Description
PresenceActivity

The created Linphone.PresenceActivity object. @notnil

CreatePresenceModel()

Creates a default LinphonePresenceModel.

Declaration
public PresenceModel CreatePresenceModel()
Returns
Type Description
PresenceModel

The created Linphone.PresenceModel object. @notnil

CreatePresenceModelWithActivity(PresenceActivityType, String)

Creates a Linphone.PresenceModel with the given activity type and activity description.

Declaration
public PresenceModel CreatePresenceModelWithActivity(PresenceActivityType acttype, string description)
Parameters
Type Name Description
PresenceActivityType acttype

The Linphone.PresenceActivityType to set for the activity of the created model.
System.String description

An additional description of the activity to set for the activity. Can be null if no additional description is to be added. @maybenil
Returns
Type Description
PresenceModel

The created Linphone.PresenceModel object. @notnil

CreatePresenceModelWithActivityAndNote(PresenceActivityType, String, String, String)

Creates a Linphone.PresenceModel with the given activity type, activity description, note content and note language.

Declaration
public PresenceModel CreatePresenceModelWithActivityAndNote(PresenceActivityType acttype, string description, string note, string lang)
Parameters
Type Name Description
PresenceActivityType acttype

The Linphone.PresenceActivityType to set for the activity of the created model.
System.String description

An additional description of the activity to set for the activity. Can be null if no additional description is to be added. @maybenil
System.String note

The content of the note to be added to the created model. @notnil
System.String lang

The language of the note to be added to the created model. @maybenil
Returns
Type Description
PresenceModel

The created Linphone.PresenceModel object. @notnil

CreatePresenceNote(String, String)

Creates a Linphone.PresenceNote with the given content and language.

Declaration
public PresenceNote CreatePresenceNote(string content, string lang)
Parameters
Type Name Description
System.String content

The content of the note to be created. @notnil
System.String lang

The language of the note to be created. @maybenil
Returns
Type Description
PresenceNote

The created Linphone.PresenceNote object. @notnil

CreatePresencePerson(String)

Creates a Linphone.PresencePerson with the given id.

Declaration
public PresencePerson CreatePresencePerson(string id)
Parameters
Type Name Description
System.String id

The id of the person to be created. @notnil
Returns
Type Description
PresencePerson

The created Linphone.PresencePerson object. @notnil

CreatePresenceService(String, PresenceBasicStatus, String)

Creates a Linphone.PresenceService with the given id, basic status and contact.

Declaration
public PresenceService CreatePresenceService(string id, PresenceBasicStatus basicStatus, string contact)
Parameters
Type Name Description
System.String id

The id of the service to be created. @notnil
PresenceBasicStatus basicStatus

The basic status of the service to be created.
System.String contact

A string containing a contact information corresponding to the service to be created. @notnil
Returns
Type Description
PresenceService

The created Linphone.PresenceService object. @notnil

CreatePrimaryContactParsed()

Same as Linphone.Core.PrimaryContact but the result is a Linphone.Address object instead of const char *.

Declaration
[Obsolete]
public Address CreatePrimaryContactParsed()
Returns
Type Description
Address

a Linphone.Address object. @maybenil
Remarks

Deprecated : prefer using Linphone.Core.PrimaryContactAddress

CreateProxyConfig()

Create a proxy config with default values from Linphone core.

Declaration
[Obsolete]
public ProxyConfig CreateProxyConfig()
Returns
Type Description
ProxyConfig

Linphone.ProxyConfig with default values set @notnil
Remarks

Deprecated : 04/09/2024 Use Linphone.Core.CreateAccount()

CreatePublish(Address, String, Int32)

Creates a publish context for an event state.

After being created, the publish must be sent using Linphone.Event.SendPublish(). After expiry, the publication is refreshed unless it is terminated before.

Declaration
public Event CreatePublish(Address resource, string ev, int expires)
Parameters
Type Name Description
Address resource

the resource uri for the event @notnil
System.String ev

the event name @notnil
System.Int32 expires

the lifetime of event being published, -1 if no associated duration, in which case it will not be refreshed.
Returns
Type Description
Event

the Linphone.Event holding the context of the publish. @notnil

CreateRecorder(RecorderParams)

Creates an independant media file recorder, that can be used to record user's voice or video outside of any call or conference.

See Linphone.Core.SupportedFileFormatsList for supported multimedia file types.

Declaration
public Recorder CreateRecorder(RecorderParams parameters)
Parameters
Type Name Description
RecorderParams parameters

The Linphone.RecorderParams that will contains all recorder parameters. @notnil
Returns
Type Description
Recorder

A pointer on the new instance. null if failed. @notnil

CreateRecorderParams()

Creates an object that holds recording parameters.

Declaration
public RecorderParams CreateRecorderParams()
Returns
Type Description
RecorderParams

A pointer on the newly created instance of Linphone.RecorderParams @notnil
Remarks

See : Linphone.Core.CreateRecorder()

CreateSipConferenceScheduler(Account)

Create a SIP conference scheduler that can be used to create client conferences for now or later and then send conference info as an ICS through chat.

A SipConferenceScheduler creates a conference on a server by using a SIP dialog

Declaration
public ConferenceScheduler CreateSipConferenceScheduler(Account account)
Parameters
Type Name Description
Account account

The Linphone.Account to use in the Linphone.ConferenceScheduler. @maybenil
Returns
Type Description
ConferenceScheduler

A pointer on the freshly created Linphone.ConferenceScheduler. @notnil

CreateSubscribe(Address, ProxyConfig, String, Int32)

Creates an outgoing subscription, specifying the destination resource, the event name, and an optional content body.

If accepted, the subscription runs for a finite period, but is automatically renewed if not terminated before. Unlike Linphone.Core.Subscribe() the subscription isn't sent immediately. It will be send when calling Linphone.Event.SendSubscribe().

Declaration
public Event CreateSubscribe(Address resource, ProxyConfig proxy, string ev, int expires)
Parameters
Type Name Description
Address resource

the destination resource @notnil
ProxyConfig proxy

the proxy configuration to use @notnil
System.String ev

the event name @notnil
System.Int32 expires

the whished duration of the subscription
Returns
Type Description
Event

a Linphone.Event holding the context of the created subcription. @notnil

CreateSubscribe(Address, String, Int32)

Creates an outgoing subscription, specifying the destination resource, the event name, and an optional content body.

If accepted, the subscription runs for a finite period, but is automatically renewed if not terminated before. Unlike Linphone.Core.Subscribe() the subscription isn't sent immediately. It will be send when calling Linphone.Event.SendSubscribe().

Declaration
public Event CreateSubscribe(Address resource, string ev, int expires)
Parameters
Type Name Description
Address resource

the destination resource @notnil
System.String ev

the event name @notnil
System.Int32 expires

the whished duration of the subscription
Returns
Type Description
Event

a Linphone.Event holding the context of the created subcription. @notnil

CreateVcardFromText(String)

Creates a vCard from a text, if possible.

Declaration
public Vcard CreateVcardFromText(string input)
Parameters
Type Name Description
System.String input

the vCard raw text to parse. @notnil
Returns
Type Description
Vcard

a new Linphone.Vcard object if the parsing of the input succeeded, null otherwise. @maybenil

CreateXmlFromEktInfo(EktInfo)

Gets an XML body.

Declaration
[Obsolete]
public string CreateXmlFromEktInfo(EktInfo ektInfo)
Parameters
Type Name Description
EktInfo ektInfo

the Linphone.EktInfo @notnil
Returns
Type Description
System.String

The XML body @maybenil
Remarks

Deprecated : 06/02/2025 use Linphone.Core.CreateXmlFromEktInfo().

CreateXmlFromEktInfo(EktInfo, Account)

Gets an XML body using a specific account.

Declaration
public string CreateXmlFromEktInfo(EktInfo ektInfo, Account account)
Parameters
Type Name Description
EktInfo ektInfo

the Linphone.EktInfo @notnil
Account account

the Linphone.Account associated with the conference @maybenil
Returns
Type Description
System.String

The XML body @maybenil

CreateXmlRpcSession(String)

Create a Linphone.XmlRpcSession for a given url.

Declaration
public XmlRpcSession CreateXmlRpcSession(string url)
Parameters
Type Name Description
System.String url

The URL to the XML-RPC server. Must be NON null. @notnil
Returns
Type Description
XmlRpcSession

The new Linphone.XmlRpcSession object. @notnil

DeleteChatRoom(ChatRoom)

Removes a chatroom including all message history from the LinphoneCore.

Declaration
public void DeleteChatRoom(ChatRoom chatRoom)
Parameters
Type Name Description
ChatRoom chatRoom

A Linphone.ChatRoom object @notnil

DeleteConferenceInformation(ConferenceInfo)

Deletes a conference information from DB.

Declaration
public void DeleteConferenceInformation(ConferenceInfo conferenceInfo)
Parameters
Type Name Description
ConferenceInfo conferenceInfo

the Linphone.ConferenceInfo to delete. @notnil

DidRegisterForRemotePush(IntPtr)

Sets device_token when application didRegisterForRemoteNotificationsWithDeviceToken (IOS only).

Declaration
public void DidRegisterForRemotePush(IntPtr deviceToken)
Parameters
Type Name Description
System.IntPtr deviceToken

format (NSData *). @maybenil

DidRegisterForRemotePushWithStringifiedToken(String)

Sets device_token when application didRegisterForRemoteNotificationsWithDeviceToken (IOS only).

Declaration
public void DidRegisterForRemotePushWithStringifiedToken(string deviceTokenStr)
Parameters
Type Name Description
System.String deviceTokenStr

string extracted from the Data objectf received in didRegisterForRemoteNotificationsWithDeviceToken ios function. Append ":remote" after data formating.. @maybenil

DisableCallRinging(Boolean)

Enables or disables call ringing.

This value is taken into account from next time call parameters are created. This feature can also be enabled per-call using Linphone.CallParams.

Declaration
public void DisableCallRinging(bool yesno)
Parameters
Type Name Description
System.Boolean yesno

a boolean to indicate whether the feature is to be disabled.

DisableChat(Reason)

Inconditionnaly disables incoming chat messages.

Declaration
public void DisableChat(Reason denyReason)
Parameters
Type Name Description
Reason denyReason

the deny reason ( Linphone.Reason.None has no effect).

EnableChat()

Enables reception of incoming chat messages.

By default it is enabled but it can be disabled with Linphone.Core.DisableChat().

Declaration
public void EnableChat()

EnableLogCollection(LogCollectionState)

Enables the linphone core log collection to upload logs on a server.

Declaration
public static void EnableLogCollection(LogCollectionState state)
Parameters
Type Name Description
LogCollectionState state

Linphone.LogCollectionState value telling whether to enable log collection or not.

EnsureRegistered()

Call this method when you receive a push notification (if you handle push notifications manually).

It will ensure the proxy configs are correctly registered to the proxy server, so the call or the message will be correctly delivered.

Declaration
[Obsolete]
public void EnsureRegistered()
Remarks

Deprecated : 09/03/2022 See Linphone.Core.ProcessPushNotification() instead.

EnterBackground()

This method is called by the application to notify the linphone core library when it enters background mode.

Declaration
public void EnterBackground()

EnterConference()

Joins the local participant to the running conference.

Declaration
[Obsolete]
public void EnterConference()
Remarks

Deprecated : 09/03/2021 Use Linphone.Conference.Enter() instead.

EnterForeground()

This method is called by the application to notify the linphone core library when it enters foreground mode.

Declaration
public void EnterForeground()

FileFormatSupported(String)

Returns whether a specific file format is supported.

Declaration
public bool FileFormatSupported(string fmt)
Parameters
Type Name Description
System.String fmt

The format extension (wav, mkv). @notnil
Returns
Type Description
System.Boolean

true if the file format is supported, false otherwise
Remarks

See : linphone_core_get_supported_file_formats

FindAuthInfo(String, String, String)

Finds authentication info matching realm, username, domain criteria.

First of all, (realm,username) pair are searched. If multiple results (which should not happen because realm are supposed to be unique), then domain is added to the search.

Declaration
public AuthInfo FindAuthInfo(string realm, string username, string sipDomain)
Parameters
Type Name Description
System.String realm

the authentication 'realm' (optional) @maybenil
System.String username

the SIP username to be authenticated (mandatory) @notnil
System.String sipDomain

the SIP domain name (optional) @maybenil
Returns
Type Description
AuthInfo

a Linphone.AuthInfo if found. @maybenil

FindCallFromUri(String)

Search from the list of current calls if a remote address match uri.

Declaration
[Obsolete]
public Call FindCallFromUri(string uri)
Parameters
Type Name Description
System.String uri

which should match call remote uri @notnil
Returns
Type Description
Call

Linphone.Call or null if no match is found. @maybenil
Remarks

Deprecated : 27/10/2020. Use Linphone.Core.CallByRemoteAddress2 instead.

FindCallLog(String, Int32)

Gets the call log matching the call id, or null if can't be found.

Declaration
public CallLog FindCallLog(string callId, int limit)
Parameters
Type Name Description
System.String callId

Call id of the call log to find @notnil
System.Int32 limit

Search limit of the most recent call logs to find @notnil
Returns
Type Description
CallLog

A call log matching the call id if any. @maybenil

FindCallLogFromCallId(String)

Gets the call log matching the call id, or null if can't be found.

Declaration
public CallLog FindCallLogFromCallId(string callId)
Parameters
Type Name Description
System.String callId

Call id of the call log to find @notnil
Returns
Type Description
CallLog

A call log matching the call id if any. @maybenil

FindChatRoom(Address, Address)

Find a chat room.

No reference is transferred to the application. The Linphone.Core keeps a reference on the chat room.

Declaration
[Obsolete]
public ChatRoom FindChatRoom(Address peerAddr, Address localAddr)
Parameters
Type Name Description
Address peerAddr

a linphone address. @notnil
Address localAddr

a linphone address. @notnil
Returns
Type Description
ChatRoom

Linphone.ChatRoom where messaging can take place. @maybenil
Remarks

Deprecated : 02/07/2020, use Linphone.Core.SearchChatRoom() instead

FindConferenceInformationFromCcmpUri(String)

Retrieve the conference information linked to the provided URI if any.

Declaration
public ConferenceInfo FindConferenceInformationFromCcmpUri(string uri)
Parameters
Type Name Description
System.String uri

Uri of the conference as provided by the CCMP server backend. @notnil
Returns
Type Description
ConferenceInfo

The Linphone.ConferenceInfo found if any, null otherwise. @maybenil

FindConferenceInformationFromUri(Address)

Retrieve the conference information linked to the provided URI if any.

Declaration
public ConferenceInfo FindConferenceInformationFromUri(Address uri)
Parameters
Type Name Description
Address uri

Linphone.Address of the uri. @notnil
Returns
Type Description
ConferenceInfo

The Linphone.ConferenceInfo found if any, null otherwise. @maybenil

FindContactsByChar(String, Boolean)

Retrieves a list of Linphone.Address sort and filter.

Declaration
public IEnumerable<Address> FindContactsByChar(string filter, bool sipOnly)
Parameters
Type Name Description
System.String filter

Chars used for the filter* @notnil
System.Boolean sipOnly

Only sip address or not
Returns
Type Description
System.Collections.Generic.IEnumerable<Address>

A list of filtered Linphone.Address

FindFriend(Address)

Searches a Linphone.Friend by its address.

Declaration
public Friend FindFriend(Address address)
Parameters
Type Name Description
Address address

The Linphone.Address to use to search the friend. @notnil
Returns
Type Description
Friend

The Linphone.Friend object corresponding to the given address or null if not found. @maybenil

FindFriendByPhoneNumber(String)

Searches a Linphone.Friend by its phone number.

Declaration
public Friend FindFriendByPhoneNumber(string phoneNumber)
Parameters
Type Name Description
System.String phoneNumber

The phone number to use to search the friend. @notnil
Returns
Type Description
Friend

The Linphone.Friend object corresponding to the given phone number or null if not found. @maybenil

FindFriends(Address)

Searches all Linphone.Friend matching an address.

Declaration
public IEnumerable<Friend> FindFriends(Address address)
Parameters
Type Name Description
Address address

The address to use to search the friends. @notnil
Returns
Type Description
System.Collections.Generic.IEnumerable<Friend>

A list of Linphone.Friend corresponding to the given address. @maybenil

FindOneToOneChatRoom(Address, Address, Boolean)

Find a one-on-one chat room.

No reference is transferred to the application. The Linphone.Core keeps a reference on the chat room.

Declaration
[Obsolete]
public ChatRoom FindOneToOneChatRoom(Address localAddr, Address participantAddr, bool encrypted)
Parameters
Type Name Description
Address localAddr

a linphone address. @notnil
Address participantAddr

a linphone address. @notnil
System.Boolean encrypted

whether to look for an encrypted chat room or not
Returns
Type Description
ChatRoom

Linphone.ChatRoom where messaging can take place. @maybenil
Remarks

Deprecated : 02/07/2020, use Linphone.Core.SearchChatRoom() instead

GetAccountByIdkey(String)

Search for a Linphone.Account by it's idkey.

Declaration
public Account GetAccountByIdkey(string idkey)
Parameters
Type Name Description
System.String idkey

An arbitrary idkey string associated to an account. @maybenil
Returns
Type Description
Account

the Linphone.Account object for the given idkey value, or null if none found @maybenil

GetCallByCallid(String)

Gets the call by its SIP callid.

Declaration
public Call GetCallByCallid(string callId)
Parameters
Type Name Description
System.String callId

of call @notnil
Returns
Type Description
Call

call Linphone.Call, return null if there is no call find. @maybenil

GetCallByRemoteAddress(String)

Get the call with the remote_address specified.

Declaration
[Obsolete]
public Call GetCallByRemoteAddress(string remoteAddress)
Parameters
Type Name Description
System.String remoteAddress

The remote address of the call that we want to get @notnil
Returns
Type Description
Call

The call if it has been found, null otherwise. @maybenil
Remarks

Deprecated : 08/07/2020 use Linphone.Core.CallByRemoteAddress2 instead

GetCallByRemoteAddress2(Address)

Get the call with the specified Linphone.Address.

Declaration
public Call GetCallByRemoteAddress2(Address remoteAddress)
Parameters
Type Name Description
Address remoteAddress

the Linphone.Address for which the call remote address must match @notnil
Returns
Type Description
Call

the Linphone.Call of the call if found. @maybenil

GetCallHistory(Address, Address)

Gets the list of call logs (past calls).

At the contrary of linphone_core_get_call_logs, it is your responsibility to unref the logs and free this list once you are done using it. Requires ENABLE_DB_STORAGE to work.

Declaration
public IEnumerable<CallLog> GetCallHistory(Address peerAddress, Address localAddress)
Parameters
Type Name Description
Address peerAddress

The remote Linphone.Address object. @notnil
Address localAddress

The local Linphone.Address object @notnil
Returns
Type Description
System.Collections.Generic.IEnumerable<CallLog>

A list of Linphone.CallLog.
@maybenil

GetChatRoom(Address)

Get a chat room whose peer is the supplied address.

If it does not exist yet, it will be created as a basic chat room. No reference is transferred to the application. The Linphone.Core keeps a reference on the chat room.

Declaration
[Obsolete]
public ChatRoom GetChatRoom(Address addr)
Parameters
Type Name Description
Address addr

a linphone address. @notnil
Returns
Type Description
ChatRoom

Linphone.ChatRoom where messaging can take place. @maybenil
Remarks

Warning : This method is prone to errors, use Linphone.Core.SearchChatRoom() instead

GetChatRoom(Address, Address)

Get a chat room.

If it does not exist yet, it will be created as a basic chat room. No reference is transferred to the application. The Linphone.Core keeps a reference on the chat room.

Declaration
[Obsolete]
public ChatRoom GetChatRoom(Address peerAddr, Address localAddr)
Parameters
Type Name Description
Address peerAddr

a linphone address. @notnil
Address localAddr

a linphone address. @notnil
Returns
Type Description
ChatRoom

Linphone.ChatRoom where messaging can take place. @maybenil
Remarks

Warning : This method is prone to errors, use Linphone.Core.SearchChatRoom() instead

GetChatRoomFromUri(String)

Get a chat room for messaging from a sip uri like sip:joe@sip.linphone.org. Get a chat room for messaging from a sip uri like sip:joe@sip.linphone.org.

If it does not exist yet, it will be created as a basic chat room. No reference is transferred to the application. The Linphone.Core keeps a reference on the chat room.

Declaration
[Obsolete]
public ChatRoom GetChatRoomFromUri(string to)
Parameters
Type Name Description
System.String to

The destination address for messages. @notnil
Returns
Type Description
ChatRoom

Linphone.ChatRoom where messaging can take place. @maybenil
Remarks

Warning : This method is prone to errors, use Linphone.Core.SearchChatRoom() instead

GetConferenceInformationListAfterTime(Int64)

Retrieve the list of conference information on DB after a certain time.

Declaration
public IEnumerable<ConferenceInfo> GetConferenceInformationListAfterTime(long time)
Parameters
Type Name Description
System.Int64 time

Time to retrieve conference info.
Returns
Type Description
System.Collections.Generic.IEnumerable<ConferenceInfo>

The list of conference infos . @maybenil

GetConferenceInformationsWithParticipant(Address)

Retrieve the list of conference information on DB where the address passed as argument is either the organizer or a participant.

Declaration
public IEnumerable<ConferenceInfo> GetConferenceInformationsWithParticipant(Address uri)
Parameters
Type Name Description
Address uri

Linphone.Address of the participant. @notnil
Returns
Type Description
System.Collections.Generic.IEnumerable<ConferenceInfo>

The list of conference infos where the address passed as argument is either the organizer or a participant. @maybenil

GetFriendByRefKey(String)

Searches a Linphone.Friend by its reference key.

Declaration
public Friend GetFriendByRefKey(string key)
Parameters
Type Name Description
System.String key

The reference key to use to search the friend. @notnil
Returns
Type Description
Friend

The Linphone.Friend object corresponding to the given reference key. @maybenil

GetFriendListByName(String)

Retrieves the list of Linphone.Friend from the core that has the given display name.

Declaration
public FriendList GetFriendListByName(string name)
Parameters
Type Name Description
System.String name

the name of the list @notnil
Returns
Type Description
FriendList

the first Linphone.FriendList object or null. @maybenil

GetPayloadType(String, Int32, Int32)

Get payload type from mime type and clock rate.

This function searches in audio and video codecs for the given payload type name and clockrate.

Declaration
public PayloadType GetPayloadType(string type, int rate, int channels)
Parameters
Type Name Description
System.String type

payload mime type (I.E "speex", "pcmu", "h264") @notnil
System.Int32 rate

can be LINPHONE_FIND_PAYLOAD_IGNORE_RATE (-1)
System.Int32 channels

number of channels, can be LINPHONE_FIND_PAYLOAD_IGNORE_CHANNELS (-1)
Returns
Type Description
PayloadType

Returns null if not found. If a Linphone.PayloadType is returned, it must be released with linphone_payload_type_unref after using it. @maybenil

GetProxyConfigByIdkey(String)

Searches for a Linphone.ProxyConfig by it's idkey.

Declaration
[Obsolete]
public ProxyConfig GetProxyConfigByIdkey(string idkey)
Parameters
Type Name Description
System.String idkey

An arbitrary idkey string associated to a proxy configuration
Returns
Type Description
ProxyConfig

the Linphone.ProxyConfig object for the given idkey value, or null if none found @maybenil
Remarks

Deprecated : 04/09/2024 Use Linphone.Core.AccountByIdkey

GetZrtpStatus(String)

Get the zrtp sas validation status for a peer uri.

Once the SAS has been validated or rejected, the status will never return to Unknown (unless you delete your cache)

Declaration
public ZrtpPeerStatus GetZrtpStatus(string addr)
Parameters
Type Name Description
System.String addr

the peer uri @notnil
Returns
Type Description
ZrtpPeerStatus
  • LinphoneZrtpPeerStatusUnknown: this uri is not present in cache OR during calls with the active device, SAS never was validated or rejected

HasBuiltinEchoCanceller()

Check whether the device has a hardware echo canceller.

Declaration
public bool HasBuiltinEchoCanceller()
Returns
Type Description
System.Boolean

true if it does, false otherwise

HasCrappyOpengl()

Check whether the device is flagged has crappy opengl.

Declaration
public bool HasCrappyOpengl()
Returns
Type Description
System.Boolean

true if crappy opengl flag is set, false otherwise

InCall()

Tells whether there is a call running.

Declaration
public bool InCall()
Returns
Type Description
System.Boolean

A boolean value telling whether a call is currently running or not

InterpretUrl(String)

Constructs a Linphone.Address from the given string if possible.

In case of just a username, characters will be unescaped. If a phone number is detected, it will be flattened. sip: or sips: prefix will be added if not present. Finally, @domain will be added if not present using default proxy config.

Declaration
[Obsolete]
public Address InterpretUrl(string url)
Parameters
Type Name Description
System.String url

the url to parse @notnil
Returns
Type Description
Address

the Linphone.Address matching the url or null in case of failure. @maybenil
Remarks

See : Linphone.ProxyConfig.NormalizeSipUri() for documentation.

InterpretUrl(String, Boolean)

Constructs a Linphone.Address from the given string if possible.

In case of just a username, characters will be unescaped. If a phone number is detected, it will be flattened. sip: or sips: prefix will be added if not present. Finally, @domain will be added if not present using the default Linphone.Account.

Declaration
public Address InterpretUrl(string url, bool applyInternationalPrefix)
Parameters
Type Name Description
System.String url

the url to parse @notnil
System.Boolean applyInternationalPrefix

whether or not to try to format url as phone number using default account prefix if it set (and if url is a number).
Returns
Type Description
Address

the Linphone.Address matching the url or null in case of failure. @maybenil
Remarks

See : Linphone.Account.NormalizeSipUri() for a similar function.

Invite(String)

Initiates an outgoing call.

The application doesn't own a reference to the returned LinphoneCall object. Use linphone_call_ref to safely keep the LinphoneCall pointer valid within your application.

Declaration
public Call Invite(string url)
Parameters
Type Name Description
System.String url

The destination of the call (sip address, or phone number). @notnil
Returns
Type Description
Call

A Linphone.Call object or null in case of failure. @maybenil

InviteAddress(Address)

Initiates an outgoing call given a destination Linphone.Address The Linphone.Address can be constructed directly using Linphone.Factory.CreateAddress(), or created by Linphone.Core.InterpretUrl().

In C, the application doesn't own a reference to the returned Linphone.Call object. Use linphone_call_ref to safely keep the Linphone.Call pointer valid within your application.

Declaration
public Call InviteAddress(Address addr)
Parameters
Type Name Description
Address addr

The destination of the call (sip address). @notnil
Returns
Type Description
Call

A Linphone.Call object or null in case of failure. @maybenil

InviteAddressWithParams(Address, CallParams)

Initiates an outgoing call given a destination Linphone.Address The Linphone.Address can be constructed directly using Linphone.Factory.CreateAddress(), or created by Linphone.Core.InterpretUrl().

In C, the application doesn't own a reference to the returned Linphone.Call object. Use linphone_call_ref to safely keep the Linphone.Call pointer valid within your application. If the Linphone.Account is not specified in parameters, the caller's account will be automatically selected by finding what is the best to reach the destination of the call.

Declaration
public Call InviteAddressWithParams(Address addr, CallParams parameters)
Parameters
Type Name Description
Address addr

The destination of the call (sip address). @notnil
CallParams parameters

Call parameters @notnil
Returns
Type Description
Call

A Linphone.Call object or null in case of failure. @maybenil

InviteAddressWithParams(Address, CallParams, String, Content)

Initiates an outgoing call given a destination Linphone.Address The Linphone.Address can be constructed directly using Linphone.Factory.CreateAddress(), or created by Linphone.Core.InterpretUrl().

In C, the application doesn't own a reference to the returned Linphone.Call object. Use linphone_call_ref to safely keep the Linphone.Call pointer valid within your application. If the Linphone.Account is not specified in parameters, the caller's account will be automatically selected by finding what is the best to reach the destination of the call.

Declaration
public Call InviteAddressWithParams(Address addr, CallParams parameters, string subject, Content content)
Parameters
Type Name Description
Address addr

The destination of the call (sip address). @notnil
CallParams parameters

Call parameters @notnil
System.String subject

Subject of the call, UTF-8 encoded @maybenil
Content content

Body of the SIP INVITE @maybenil
Returns
Type Description
Call

A Linphone.Call object or null in case of failure. @maybenil

InviteWithParams(String, CallParams)

Initiates an outgoing call according to supplied call parameters In C, the application doesn't own a reference to the returned Linphone.Call object.

Use linphone_call_ref to safely keep the Linphone.Call pointer valid within your application.

Declaration
public Call InviteWithParams(string url, CallParams parameters)
Parameters
Type Name Description
System.String url

The destination of the call (sip address, or phone number). @notnil
CallParams parameters

the Linphone.CallParams call parameters @notnil
Returns
Type Description
Call

A Linphone.Call object or null in case of failure. @maybenil

IsContentTypeSupported(String)

Tells whether a content type is supported.

Declaration
public bool IsContentTypeSupported(string contentType)
Parameters
Type Name Description
System.String contentType

The content type to check @notnil
Returns
Type Description
System.Boolean

A boolean value telling whether the specified content type is supported or not.

IsMediaEncryptionSupported(MediaEncryption)

Checks if given media encryption is supported.

Declaration
public bool IsMediaEncryptionSupported(MediaEncryption menc)
Parameters
Type Name Description
MediaEncryption menc

The media encryption policy to be used.
Returns
Type Description
System.Boolean

true if the media encryption is supported, false otherwise

IsMediaFilterSupported(String)

Checks if the given media filter is loaded and usable.

This is for advanced users of the library, mainly to expose mediastreamer video filter status.

Declaration
public bool IsMediaFilterSupported(string filtername)
Parameters
Type Name Description
System.String filtername

the filter name @notnil
Returns
Type Description
System.Boolean

true if the filter is loaded and usable, false otherwise

IsPluginLoaded(String)

Tells whether a plugin is loaded or not.

Declaration
public bool IsPluginLoaded(string name)
Parameters
Type Name Description
System.String name

name of the plugin @notnil
Returns
Type Description
System.Boolean

A boolean value telling whether the plugin has been loaded

Iterate()

Main loop integration.

Unless auto-iterate mode is provided ( see Linphone.Core.EnableAutoIterate() ), it is crucial that your application calls Linphone.Core.Iterate() repeatedly. Linphone.Core.Iterate() performs various backgrounds tasks: -receiving of SIP messages -handles timers and timeout -performs registration to proxies -authentication retries The application must call this function periodically, from the same thread it uses for calling other liblinphone methods. It may triggered from the timer in the application's main loop if the application design is single thread model, or from an application thread if the application decides to perform all liblinphone invocations from a dedicated thread. If it is not the case make sure all liblinphone calls are serialized with a mutex. A recommanded timer value is 20 ms for calling this function.

Declaration
public void Iterate()

LdapAvailable()

End of group contacts.

Tells if LDAP is available

Declaration
public bool LdapAvailable()
Returns
Type Description
System.Boolean

true if LDAP is available, false otherwise

LeaveConference()

Makes the local participant leave the running conference.

Declaration
[Obsolete]
public void LeaveConference()
Remarks

Deprecated : 09/03/2021 Use Linphone.Conference.Leave() instead.

LimeX3DhAvailable()

Tells if LIME X3DH is available.

Declaration
public bool LimeX3DhAvailable()
Returns
Type Description
System.Boolean

LoadConfigFromXml(String)

Update current config with the content of a xml config file.

Declaration
public void LoadConfigFromXml(string xmlUri)
Parameters
Type Name Description
System.String xmlUri

the path to the xml file @notnil

LogCollectionEnabled()

Tells whether the linphone core log collection is enabled.

Declaration
public static LogCollectionState LogCollectionEnabled()
Returns
Type Description
LogCollectionState

The Linphone.LogCollectionState of the Linphone.Core log collection.

MediaEncryptionSupported(MediaEncryption)

Checks if a media encryption type is supported.

Declaration
public bool MediaEncryptionSupported(MediaEncryption menc)
Parameters
Type Name Description
MediaEncryption menc

Linphone.MediaEncryption
Returns
Type Description
System.Boolean

whether a media encryption scheme is supported by the Linphone.Core engine

MigrateLogsFromRcToDb()

Migrates the call logs from the linphonerc to the database if not done yet.

Declaration
public void MigrateLogsFromRcToDb()

NotifyAllFriends(PresenceModel)

Notifies all friends that have subscribed.

Declaration
public void NotifyAllFriends(PresenceModel presence)
Parameters
Type Name Description
PresenceModel presence

Linphone.PresenceModel to notify @notnil

NotifyNotifyPresenceReceived(Friend)

Notifies the upper layer that a presence status has been received by calling the appropriate callback if one has been set.

This method is for advanced usage, where customization of the liblinphone's internal behavior is required.

Declaration
public void NotifyNotifyPresenceReceived(Friend linphoneFriend)
Parameters
Type Name Description
Friend linphoneFriend

the Linphone.Friend whose presence information has been received. @notnil

NotifyNotifyPresenceReceivedForUriOrTel(Friend, String, PresenceModel)

Notifies the upper layer that a presence model change has been received for the uri or telephone number given as a parameter, by calling the appropriate callback if one has been set.

This method is for advanced usage, where customization of the liblinphone's internal behavior is required.

Declaration
public void NotifyNotifyPresenceReceivedForUriOrTel(Friend linphoneFriend, string uriOrTel, PresenceModel presenceModel)
Parameters
Type Name Description
Friend linphoneFriend

the Linphone.Friend whose presence information has been received. @notnil
System.String uriOrTel

telephone number or sip uri @notnil
PresenceModel presenceModel

the Linphone.PresenceModel that has been modified @notnil

PauseAllCalls()

Pauses all currently running calls.

Declaration
public void PauseAllCalls()

PlayDtmf(SByte, Int32)

Plays a dtmf sound to the local user.

Declaration
public void PlayDtmf(sbyte dtmf, int durationMs)
Parameters
Type Name Description
System.SByte dtmf

DTMF to play ['0'..'16'] | '#' | '#'
System.Int32 durationMs

Duration in ms, -1 means play until next further call to Linphone.Core.StopDtmf()

PlayLocal(String)

Plays an audio file to the local user.

This function works at any time, during calls, or when no calls are running. It doesn't request the underlying audio system to support multiple playback streams.

Declaration
public void PlayLocal(string audiofile)
Parameters
Type Name Description
System.String audiofile

The path to an audio file in wav PCM 16 bit format @notnil

PreemptSoundResources()

Empties sound resources to allow a new call to be accepted.

This function is autyomatically called by the core if the media resource mode is set to unique.

Declaration
public int PreemptSoundResources()
Returns
Type Description
System.Int32

An integer returning the exit value. If it is 0, sound resources have been emptied. Otherwise, sound resources are busy and cannot be freed immediately.

PreviewOglRender()

Call generic OpenGL render for a given core.

Declaration
public void PreviewOglRender()

ProcessPushNotification(String)

Call this method when you receive a push notification (if you handle push notifications manually).

It will ensure the proxy configs are correctly registered to the proxy server, so the call or the message will be correctly delivered.

Declaration
public void ProcessPushNotification(string callId)
Parameters
Type Name Description
System.String callId

the Call-ID of the MESSAGE or INVITE for which the push was received and to wait for. @maybenil

Publish(Address, String, Int32, Content)

Publishes an event state.

This first create a Linphone.Event with Linphone.Core.CreatePublish() and calls Linphone.Event.SendPublish() to actually send it. After expiry, the publication is refreshed unless it is terminated before.

Declaration
public Event Publish(Address resource, string ev, int expires, Content body)
Parameters
Type Name Description
Address resource

the resource uri for the event @notnil
System.String ev

the event name @notnil
System.Int32 expires

the lifetime of event being published, -1 if no associated duration, in which case it will not be refreshed.
Content body

the actual published data @notnil
Returns
Type Description
Event

the Linphone.Event holding the context of the publish. @maybenil

RefreshRegisters()

Forces registration refresh to be initiated upon next iterate.

Declaration
public void RefreshRegisters()

RejectSubscriber(Friend)

Black list a friend.

same as Linphone.Friend.IncSubscribePolicy with Linphone.SubscribePolicy.SPDeny policy;

Declaration
public void RejectSubscriber(Friend linphoneFriend)
Parameters
Type Name Description
Friend linphoneFriend

Linphone.Friend to reject @notnil

ReloadMsPlugins(String)

Reload mediastreamer2 plugins from specified directory.

Declaration
public void ReloadMsPlugins(string path)
Parameters
Type Name Description
System.String path

the path from where plugins are to be loaded, pass null to use default (compile-time determined) plugin directory. @maybenil

ReloadSoundDevices()

Update detection of sound devices.

Use this function when the application is notified of USB plug events, so that list of available hardwares for sound playback and capture is updated.

Declaration
public void ReloadSoundDevices()

ReloadVideoDevices()

Update detection of camera devices.

Use this function when the application is notified of USB plug events, so that list of available hardwares for video capture is updated.

Declaration
public void ReloadVideoDevices()

RemoveAccount(Account)

Removes an account.

Linphone.Core will then automatically unregister and place the account on a deleted list. For that reason, a removed account does NOT need to be freed.

Declaration
public void RemoveAccount(Account account)
Parameters
Type Name Description
Account account

the Linphone.Account to remove @notnil

RemoveAccountWithData(Account)

Removes an account and any associated data.

Linphone.Core will then automatically unregister and place the account on a deleted list. For that reason, a removed account does NOT need to be freed.

Declaration
public void RemoveAccountWithData(Account account)
Parameters
Type Name Description
Account account

the Linphone.Account to remove @notnil

RemoveAuthInfo(AuthInfo)

Removes an authentication information object.

Declaration
public void RemoveAuthInfo(AuthInfo info)
Parameters
Type Name Description
AuthInfo info

The Linphone.AuthInfo to remove. @notnil

RemoveCallLog(CallLog)

Removes a specific call log from call history list.

This function destroys the call log object. It must not be accessed anymore by the application after calling this function.

Declaration
public void RemoveCallLog(CallLog callLog)
Parameters
Type Name Description
CallLog callLog

Linphone.CallLog object to remove. @notnil

RemoveContentTypeSupport(String)

Remove support for the specified content type.

It is the application responsibility to handle it correctly afterwards.

Declaration
public void RemoveContentTypeSupport(string contentType)
Parameters
Type Name Description
System.String contentType

The content type to remove support for @notnil

RemoveFriendList(FriendList)

Removes a friend list.

Declaration
public void RemoveFriendList(FriendList list)
Parameters
Type Name Description
FriendList list

Linphone.FriendList object @notnil

RemoveFromConference(Call)

Removes a call from the conference.

Declaration
[Obsolete]
public void RemoveFromConference(Call call)
Parameters
Type Name Description
Call call

a call that has been previously merged into the conference. @notnil
Remarks

Deprecated : 23/01/2025 Use Linphone.Conference.RemoveParticipant() instead.

RemoveLdap(Ldap)

Remove a LDAP from the configuration.

Declaration
[Obsolete]
public void RemoveLdap(Ldap ldap)
Parameters
Type Name Description
Ldap ldap

The Linphone.Ldap object to remove. @notnil
Remarks

Deprecated : 18/11/2024 use Linphone.Core.RemoveRemoteContactDirectory() instead.

RemoveLinphoneSpec(String)

Remove the given linphone specs from the list of functionalities the linphone client supports.

Declaration
public void RemoveLinphoneSpec(string spec)
Parameters
Type Name Description
System.String spec

The spec to remove @notnil
Remarks

See : Linphone.Core.LinphoneSpecsList

RemoveProxyConfig(ProxyConfig)

Removes a proxy configuration.

Linphone.Core will then automatically unregister and place the proxy configuration on a deleted list. For that reason, a removed proxy does NOT need to be freed.

Declaration
[Obsolete]
public void RemoveProxyConfig(ProxyConfig config)
Parameters
Type Name Description
ProxyConfig config

the Linphone.ProxyConfig to remove @notnil
Remarks

Deprecated : 04/09/2024 Use Linphone.Core.RemoveAccount()

RemoveRemoteContactDirectory(RemoteContactDirectory)

Removes a Linphone.RemoteContactDirectory object previously added to the Core.

Declaration
public void RemoveRemoteContactDirectory(RemoteContactDirectory remoteContactDirectory)
Parameters
Type Name Description
RemoteContactDirectory remoteContactDirectory

the Linphone.RemoteContactDirectory to remove. @notnil

RemoveSupportedTag(String)

Remove a supported tag.

Declaration
public void RemoveSupportedTag(string tag)
Parameters
Type Name Description
System.String tag

The tag to remove @notnil
Remarks

See : Linphone.Core.AddSupportedTag()

ResetEchoCancellationCalibration()

Clears all state resulting from a previous echo canceller calibration procedure, which restores default policy and settings for echo cancellation.

Declaration
public void ResetEchoCancellationCalibration()
Remarks

See : Linphone.Core.EnableEchoCancellation() and Linphone.Core.StartEchoCancellerCalibration()

ResetLogCollection()

Resets the log collection by removing the log files.

Declaration
public static void ResetLogCollection()

ResetMissedCallsCount()

Resets the counter of missed calls.

Declaration
public void ResetMissedCallsCount()

SearchChatRoom(ChatRoomParams, Address, Address, IEnumerable<Address>)

Find a chat room.

Declaration
[Obsolete]
public ChatRoom SearchChatRoom(ChatRoomParams parameters, Address localAddr, Address remoteAddr, IEnumerable<Address> participants)
Parameters
Type Name Description
ChatRoomParams parameters

The chat room parameters to match Linphone.ChatRoomParams or null @maybenil
Address localAddr

Linphone.Address of a local Linphone.Account identity or null @maybenil
Address remoteAddr

Linphone.Address to search for or null @maybenil
System.Collections.Generic.IEnumerable<Address> participants

The participants that must be present in the chat room to find. @maybenil
Returns
Type Description
ChatRoom

A matching chat room or null if none matches. @maybenil
Remarks

Deprecated : 22/10/2024, use Linphone.Core.SearchChatRoom() instead

SearchChatRoom(ConferenceParams, Address, Address, IEnumerable<Address>)

Find a chat room.

Declaration
public ChatRoom SearchChatRoom(ConferenceParams parameters, Address localAddr, Address remoteAddr, IEnumerable<Address> participants)
Parameters
Type Name Description
ConferenceParams parameters

The chat room parameters to match Linphone.ChatRoomParams or null @maybenil
Address localAddr

Linphone.Address of a local Linphone.Account identity or null @maybenil
Address remoteAddr

Linphone.Address to search for or null @maybenil
System.Collections.Generic.IEnumerable<Address> participants

The participants that must be present in the chat room to find. @maybenil
Returns
Type Description
ChatRoom

A matching chat room or null if none matches. @maybenil

SearchChatRoomByIdentifier(String)

Find a chat room by its identifier.

Declaration
public ChatRoom SearchChatRoomByIdentifier(string identifier)
Parameters
Type Name Description
System.String identifier

The chat room identifier @notnil
Returns
Type Description
ChatRoom

A matching chat room or null if none matches. @maybenil

SearchConference(Address)

Finds a conference.

Declaration
public Conference SearchConference(Address conferenceAddr)
Parameters
Type Name Description
Address conferenceAddr

Linphone.Address representing the conference address @notnil
Returns
Type Description
Conference

A pointer on Linphone.Conference whose conference address is the one provided as argument or null if none matches @maybenil

SearchConference(ConferenceParams, Address, Address, IEnumerable<Address>)

Find a conference.

Declaration
public Conference SearchConference(ConferenceParams parameters, Address localAddr, Address remoteAddr, IEnumerable<Address> participants)
Parameters
Type Name Description
ConferenceParams parameters

The conference parameters to match Linphone.ConferenceParams or null @maybenil
Address localAddr

Linphone.Address representing the local proxy configuration or null @maybenil
Address remoteAddr

Linphone.Address to search for or null @maybenil
System.Collections.Generic.IEnumerable<Address> participants

The participants that must be present in the chat room to find @maybenil
Returns
Type Description
Conference

A pointer on Linphone.Conference satisfying the non-null function arguments or null if none matches @maybenil

SearchConferenceByIdentifier(String)

Find a conference by its identifier.

Declaration
public Conference SearchConferenceByIdentifier(string identifier)
Parameters
Type Name Description
System.String identifier

The conference identifier @notnil
Returns
Type Description
Conference

A matching conference or null if none matches. @maybenil

SerializeLogs()

Enables logs serialization (output logs from either the thread that creates the linphone core or the thread that calls Linphone.Core.Iterate()).

Must be called before creating the Linphone.Core.

Declaration
public static void SerializeLogs()

SetAudioPortRange(Int32, Int32)

Sets the UDP port range from which to randomly select the port used for audio streaming.

Declaration
public void SetAudioPortRange(int minPort, int maxPort)
Parameters
Type Name Description
System.Int32 minPort

The lower bound of the audio port range to use
System.Int32 maxPort

The upper bound of the audio port range to use

SetLogCollectionMaxFileSize(Int64)

Sets the max file size in bytes of the files used for log collection.

Warning: this function should only not be used to change size dynamically but instead only before calling Linphone.Core.EnableLogCollection(). If you increase max size on runtime, logs chronological order COULD be broken.

Declaration
public static void SetLogCollectionMaxFileSize(long size)
Parameters
Type Name Description
System.Int64 size

The max file size in bytes of the files used for log collection.

SetLogCollectionPath(String)

Sets the path of a directory where the log files will be written for log collection.

When log collection is enabled, the function will close the file with the current prefix in the old path and it will open the new file with current prefix in the new path. If you need to change the path and the file at the same time, then you should deactivate log collection with Linphone.Core.EnableLogCollection() before doing modifications.

Declaration
public static void SetLogCollectionPath(string path)
Parameters
Type Name Description
System.String path

The path where the log files will be written. @notnil

SetLogCollectionPrefix(String)

Sets the prefix of the filenames that will be used for log collection.

When log collection is enabled, the function will close the old file and it will open the new one in the current path. If you need to change the path and the file at the same time, then you should deactivate log collection with Linphone.Core.EnableLogCollection() before doing modifications.

Declaration
public static void SetLogCollectionPrefix(string prefix)
Parameters
Type Name Description
System.String prefix

The prefix to use for the filenames for log collection. @notnil

SetQrcodeDecodeRect(Int32, Int32, Int32, Int32)

Set the rectangle where the decoder will search a QRCode.

Declaration
public void SetQrcodeDecodeRect(int x, int y, int w, int h)
Parameters
Type Name Description
System.Int32 x

axis
System.Int32 y

axis
System.Int32 w

width
System.Int32 h

height

SetRefreshWindow(Int32, Int32)

Set the refresh window.

During this window, belle-sip schedules the refreshes of the sip messages

Declaration
public void SetRefreshWindow(int minValue, int maxValue)
Parameters
Type Name Description
System.Int32 minValue

lower bound of the refresh window
System.Int32 maxValue

upper bound of the refresh window
Remarks

Warning : The refresh window must be set before starting the core

SetTextPortRange(Int32, Int32)

Sets the UDP port range from which to randomly select the port used for text streaming.

Declaration
public void SetTextPortRange(int minPort, int maxPort)
Parameters
Type Name Description
System.Int32 minPort

The lower bound of the text port range to use
System.Int32 maxPort

The upper bound of the text port range to use

SetTone(ToneID, String)

Assign an audio file to be played as a specific tone id.

This function typically allows to customize telephony tones per country. If you want to disable a tone, set a path to a non-existent file. To disable all tones, use Linphone.Core.EnableCallToneIndications() or set the tone_indications to 0 in the [misc] section of your linphonerc. If you want to disable a tone, set a path to a non-existent file. To disable all tones, use Linphone.Core.EnableCallToneIndications() or set the tone_indications to 0 in the [misc] section of your linphonerc.

Declaration
public void SetTone(ToneID toneId, string audiofile)
Parameters
Type Name Description
ToneID toneId

the Linphone.ToneID
System.String audiofile

a wav file to be played or null to use the default (generated) one. @maybenil

SetUserAgent(String, String)

Set the user agent string used in SIP messages.

Set the user agent string used in SIP messages as "[ua_name]/[version]". No slash character will be printed if null is given to "version". If null is given to "ua_name" and "version" both, the User-agent header will be empty. This function should be called just after linphone_factory_create_core ideally.

Declaration
public void SetUserAgent(string name, string version)
Parameters
Type Name Description
System.String name

Name of the user agent. @maybenil
System.String version

Version of the user agent. @maybenil

SetVideoPortRange(Int32, Int32)

Sets the UDP port range from which to randomly select the port used for video streaming.

Declaration
public void SetVideoPortRange(int minPort, int maxPort)
Parameters
Type Name Description
System.Int32 minPort

The lower bound of the video port range to use
System.Int32 maxPort

The upper bound of the video port range to use

SoundDeviceCanCapture(String)

Tells whether a specified sound device can capture sound.

Declaration
[Obsolete]
public bool SoundDeviceCanCapture(string device)
Parameters
Type Name Description
System.String device

the device name as returned by linphone_core_get_sound_devices @notnil
Returns
Type Description
System.Boolean

A boolean value telling whether the specified sound device can capture sound
Remarks

Deprecated : 08/07/2020 use Linphone.AudioDevice API instead()

SoundDeviceCanPlayback(String)

Tells whether a specified sound device can play sound.

Declaration
[Obsolete]
public bool SoundDeviceCanPlayback(string device)
Parameters
Type Name Description
System.String device

the device name as returned by linphone_core_get_sound_devices @notnil
Returns
Type Description
System.Boolean

A boolean value telling whether the specified sound device can play sound
Remarks

Deprecated : 08/07/2020 use Linphone.AudioDevice API instead()

SoundResourcesLocked()

Checks if a call will need the sound resources in near future (typically an outgoing call that is awaiting response).

In liblinphone, it is not possible to have two independant calls using sound device or camera at the same time. In order to prevent this situation, an application can use Linphone.Core.SoundResourcesLocked() to know whether it is possible at a given time to start a new outgoing call. When the function returns true, an application should not allow the user to start an outgoing call.

Declaration
public bool SoundResourcesLocked()
Returns
Type Description
System.Boolean

A boolean value telling whether a call will need the sound resources in near future

Start()

Starts a Linphone.Core object after it has been instantiated and not automatically started.

Also re-initialize a Linphone.Core object that has been stopped using Linphone.Core.Stop(). Must be called only if Linphone.GlobalState is either Ready of Off. State will changed to Startup, Configuring and then On.

Declaration
public void Start()

StartEchoCancellerCalibration()

Starts an echo calibration of the sound devices, in order to find adequate settings for the echo canceler automatically.

Declaration
public void StartEchoCancellerCalibration()

StartEchoTester(UInt32)

Start the simulation of call to test the latency with an external device.

Declaration
public void StartEchoTester(uint rate)
Parameters
Type Name Description
System.UInt32 rate

Sound sample rate.

Stop()

Stops a Linphone.Core object after it has been instantiated and started.

If stopped, it can be started again using Linphone.Core.Start(). Must be called only if Linphone.GlobalState is either On. State will changed to Shutdown and then Off. This function may block to perform SIP server unregistration. Using Linphone.Core.StopAsync() is preferred.

Declaration
public void Stop()
Remarks

Warning : This function must never be called from within an event notification triggered by Liblinphone.

StopAsync()

Asynchronously stops a Linphone.Core object after it has been instantiated and started.

State changes to Shutdown then Linphone.Core.Iterate() must be called to allow the Core to end asynchronous tasks (terminate call, etc.). When all tasks are finished, State will change to Off. Must be called only if Linphone.GlobalState is On. When Linphone.GlobalState is Off Linphone.Core can be started again using Linphone.Core.Start().

Declaration
public void StopAsync()
Remarks

Warning : This function must never be called from within an event notification triggered by Liblinphone.

StopDtmf()

Stops playing a dtmf started by Linphone.Core.PlayDtmf().

Declaration
public void StopDtmf()

StopEchoTester()

Stop the simulation of call.

Declaration
public void StopEchoTester()

StopRinging()

Whenever the liblinphone is playing a ring to advertise an incoming call or ringback of an outgoing call, this function stops the ringing.

Typical use is to stop ringing when the user requests to ignore the call.

Declaration
public void StopRinging()

Subscribe(Address, String, Int32, Content)

Creates and send an outgoing subscription, specifying the destination resource, the event name, and an optional content body.

If accepted, the subscription runs for a finite period, but is automatically renewed if not terminated before.

Declaration
public Event Subscribe(Address resource, string ev, int expires, Content body)
Parameters
Type Name Description
Address resource

the destination resource @notnil
System.String ev

the event name @notnil
System.Int32 expires

the whished duration of the subscription
Content body

an optional body, may be null. @maybenil
Returns
Type Description
Event

a Linphone.Event holding the context of the created subcription. @notnil

TakePreviewSnapshot(String)

Takes a photo of currently from capture device and write it into a jpeg file.

Note that the snapshot is asynchronous, an application shall not assume that the file is created when the function returns.

Declaration
public void TakePreviewSnapshot(string file)
Parameters
Type Name Description
System.String file

a path where to write the jpeg content. @notnil

TerminateAllCalls()

Terminates all the calls.

Declaration
public void TerminateAllCalls()

TerminateConference()

Terminates the running conference.

If it is a local conference, all calls inside it will become back separate calls and will be put in LinphoneCallPaused state. If it is a conference involving a focus server, all calls inside the conference will be terminated. If it is a local conference, all calls inside it will become back separate calls and will be put in LinphoneCallPaused state. If it is a conference involving a focus server, all calls inside the conference will be terminated.

Declaration
[Obsolete]
public void TerminateConference()
Remarks

Deprecated : 23/01/2025 Use Linphone.Conference.Terminate() instead.

TunnelAvailable()

True if tunnel extension was compiled.

Declaration
public static bool TunnelAvailable()
Returns
Type Description
System.Boolean

true if library was built with tunnel, false otherwise

UpgradeDatabase()

Upgrade the database manually to the latest schema.

Declaration
public void UpgradeDatabase()

UploadLogCollection()

Uploads the log collection to the configured server url.

Declaration
public void UploadLogCollection()

UpnpAvailable()

Return the availability of uPnP.

Declaration
public static bool UpnpAvailable()
Returns
Type Description
System.Boolean

true if uPnP is available otherwise return false.
Remarks

Warning : UPNP support has been removed, and proved to be useless.

UsePreviewWindow(Boolean)

Tells the core to use a separate window for local camera preview video, instead of inserting local view within the remote video window.

Declaration
public void UsePreviewWindow(bool yesno)
Parameters
Type Name Description
System.Boolean yesno

true to use a separate window, false to insert the preview in the remote video window.

VcardSupported()

Tells whether VCARD support is builtin.

Declaration
public static bool VcardSupported()
Returns
Type Description
System.Boolean

true if VCARD is supported, false otherwise.

VerifyServerCertificates(Boolean)

Specify whether the tls server certificate must be verified when connecting to a SIP/TLS server.

Declaration
public void VerifyServerCertificates(bool yesno)
Parameters
Type Name Description
System.Boolean yesno

A boolean value telling whether the tls server certificate must be verified

VerifyServerCn(Boolean)

Specify whether the tls server certificate common name must be verified when connecting to a SIP/TLS server.

Declaration
public void VerifyServerCn(bool yesno)
Parameters
Type Name Description
System.Boolean yesno

A boolean value telling whether the tls server certificate common name must be verified

VideoSupported()

Test if video is supported.

Declaration
public bool VideoSupported()
Returns
Type Description
System.Boolean

true if the library was built with video support, false otherwise