Class CallParams

An object containing various parameters of a Call.

You can specify your params while answering an incoming call using Linphone.Call.AcceptWithParams() or while initiating an outgoing call with Linphone.Core.InviteAddressWithParams(). This object can be created using Linphone.Core.CreateCallParams(), using null for the call pointer if you plan to use it for an outgoing call. For each call, three CallParams are available: yours, your correspondent's and the one that describe the current state of the call that is the result of the negociation between the previous two. For example, you might enable a certain feature in your call param but this feature can be denied in the remote's configuration, hence the difference.

Inheritance

System.Object

LinphoneObject

CallParams

Inherited Members

LinphoneObject.StringArrayToBctbxList(IEnumerable<String>)

LinphoneObject.CleanStringArrayPtrs()

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 CallParams : LinphoneObject

Remarks

See : CurrentParams, RemoteParams and Params.

Properties

AudioBandwidthLimit

Refine bandwidth settings for this call by setting a bandwidth limit for audio streams.

As a consequence, codecs whose bitrates are not compatible with this limit won't be used.

Declaration

public int AudioBandwidthLimit { set; }

Property Value

Type	Description
System.Int32

AudioDirection

Get the audio stream direction.

Declaration

public MediaDirection AudioDirection { get; set; }

Property Value

Type	Description
MediaDirection	The audio stream MediaDirection associated with the call params.

AudioEnabled

Tell whether audio is enabled or not.

Declaration

public bool AudioEnabled { get; set; }

Property Value

Type	Description
System.Boolean	A boolean value telling whether audio is enabled or not.

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 AudioMulticastAddr

AvpfEnabled

Set the video stream direction.

Declaration

public bool AvpfEnabled { set; }

Property Value

Type	Description
System.Boolean

CustomContents

Gets a list of Content set if exists.

Declaration

public IEnumerable<Content> CustomContents { get; }

Property Value

Type	Description
System.Collections.Generic.IEnumerable<Content>	A list of Content set if exists, null otherwise.

EarlyMediaSendingEnabled

Indicate whether sending of early media was enabled.

Declaration

public bool EarlyMediaSendingEnabled { get; set; }

Property Value

Type	Description
System.Boolean	A boolean value telling whether sending of early media was enabled.

LocalConferenceMode

Tell whether the call is part of the locally managed conference.

Declaration

public bool LocalConferenceMode { get; }

Property Value

Type	Description
System.Boolean	A boolean value telling whether the call is part of the locally managed conference.

Remarks

Warning : If a conference server is used to manage conferences, that function does not return true even if the conference is running. If you want to test whether the conference is running, you should test whether Conference return a non-null pointer.

LowBandwidthEnabled

Tell whether the call has been configured in low bandwidth mode or not.

This mode can be automatically discovered thanks to a stun server when activate_edge_workarounds=1 in section [net] of configuration file. An application that would have reliable way to know network capacity may not use activate_edge_workarounds=1 but instead manually configure low bandwidth mode with Linphone.CallParams.EnableLowBandwidth(). When enabled, this param may transform a call request with video in audio only mode.

Declaration

public bool LowBandwidthEnabled { get; set; }

Property Value

Type	Description
System.Boolean	A boolean value telling whether the low bandwidth mode has been configured/detected.

MediaEncryption

Get the kind of media encryption selected for the call.

Declaration

public MediaEncryption MediaEncryption { get; set; }

Property Value

Type	Description
MediaEncryption	The kind of MediaEncryption selected for the call.

Privacy

Get requested level of privacy for the call.

Declaration

public uint Privacy { get; set; }

Property Value

Type	Description
System.UInt32	The LinphonePrivacyMask used for the call.

ProxyConfig

Get the ProxyConfig that is used for the call.

Declaration

public ProxyConfig ProxyConfig { get; set; }

Property Value

Type	Description
ProxyConfig	The selected ProxyConfig for the call, or null if none has been selected.

RealtimeTextEnabled

Use to get real time text following rfc4103.

Declaration

public bool RealtimeTextEnabled { get; set; }

Property Value

Type	Description
System.Boolean	returns true if call rtt is activated.

RealtimeTextKeepaliveInterval

Use to get keep alive interval of real time text following rfc4103.

Declaration

public uint RealtimeTextKeepaliveInterval { get; set; }

Property Value

Type	Description
System.UInt32	returns keep alive interval of real time text.

ReceivedFramerate

Get the framerate of the video that is received.

Declaration

public float ReceivedFramerate { get; }

Property Value

Type	Description
System.Single	The actual received framerate in frames per seconds, 0 if not available.

ReceivedVideoDefinition

Get the definition of the received video.

Declaration

public VideoDefinition ReceivedVideoDefinition { get; }

Property Value

Type	Description
VideoDefinition	The received VideoDefinition or null.

RecordFile

Get the path for the audio recording of the call.

Declaration

public string RecordFile { get; set; }

Property Value

Type	Description
System.String	The path to the audio recording of the call or null.

RtpBundleEnabled

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

See https://tools.ietf.org/html/draft-ietf-mmusic-sdp-bundle-negotiation-54 for more information.

Declaration

public bool RtpBundleEnabled { get; set; }

Property Value

Type	Description
System.Boolean	a boolean indicating the enablement of rtp bundle mode.

RtpProfile

Get the RTP profile being used.

Declaration

public string RtpProfile { get; }

Property Value

Type	Description
System.String	The RTP profile.

SentFramerate

Get the framerate of the video that is sent.

Declaration

public float SentFramerate { get; }

Property Value

Type	Description
System.Single	The actual sent framerate in frames per seconds, 0 if not available.

SentVideoDefinition

Get the definition of the sent video.

Declaration

public VideoDefinition SentVideoDefinition { get; }

Property Value

Type	Description
VideoDefinition	The sent VideoDefinition or null.

SessionName

Get the session name of the media session (ie in SDP).

Subject from the SIP message can be retrieved using Linphone.CallParams.CustomHeader and is different.

Declaration

public string SessionName { get; set; }

Property Value

Type	Description
System.String	The session name of the media session or null.

UsedAudioPayloadType

Get the audio payload type that has been selected by a call.

Declaration

public PayloadType UsedAudioPayloadType { get; }

Property Value

Type	Description
PayloadType	The selected PayloadType. null is returned if no audio payload type has been selected by the call.

UsedTextPayloadType

Get the text payload type that has been selected by a call.

Declaration

public PayloadType UsedTextPayloadType { get; }

Property Value

Type	Description
PayloadType	The selected PayloadType. null is returned if no text payload type has been selected by the call.

UsedVideoPayloadType

Get the video payload type that has been selected by a call.

Declaration

public PayloadType UsedVideoPayloadType { get; }

Property Value

Type	Description
PayloadType	The selected PayloadType. null is returned if no video payload type has been selected by the call.

VideoDirection

Get the video stream direction.

Declaration

public MediaDirection VideoDirection { get; set; }

Property Value

Type	Description
MediaDirection	The video stream MediaDirection associated with the call params.

VideoEnabled

Tell whether video is enabled or not.

Declaration

public bool VideoEnabled { get; set; }

Property Value

Type	Description
System.Boolean	A boolean value telling whether video is enabled or not.

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 VideoMulticastAddr

Methods

AddCustomContent(Content)

Adds a Content to be added to the INVITE SDP.

Declaration

public void AddCustomContent(Content content)

Parameters

Type	Name	Description
Content	content	The Content to be added.

AddCustomHeader(String, String)

Add a custom SIP header in the INVITE for a call.

Declaration

public void AddCustomHeader(string headerName, string headerValue)

Parameters

Type	Name	Description
System.String	headerName	The name of the header to add.
System.String	headerValue	The content of the header to add.

AddCustomSdpAttribute(String, String)

Add a custom attribute related to all the streams in the SDP exchanged within SIP messages during a call.

Declaration

public void AddCustomSdpAttribute(string attributeName, string attributeValue)

Parameters

Type	Name	Description
System.String	attributeName	The name of the attribute to add.
System.String	attributeValue	The content value of the attribute to add.

AddCustomSdpMediaAttribute(StreamType, String, String)

Add a custom attribute related to a specific stream in the SDP exchanged within SIP messages during a call.

Declaration

public void AddCustomSdpMediaAttribute(StreamType type, string attributeName, string attributeValue)

Parameters

Type	Name	Description
StreamType	type	The type of the stream to add a custom SDP attribute to.
System.String	attributeName	The name of the attribute to add.
System.String	attributeValue	The content value of the attribute to add.

ClearCustomSdpAttributes()

Clear the custom SDP attributes related to all the streams in the SDP exchanged within SIP messages during a call.

Declaration

public void ClearCustomSdpAttributes()

ClearCustomSdpMediaAttributes(StreamType)

Clear the custom SDP attributes related to a specific stream in the SDP exchanged within SIP messages during a call.

Declaration

public void ClearCustomSdpMediaAttributes(StreamType type)

Parameters

Type	Name	Description
StreamType	type	The type of the stream to clear the custom SDP attributes from.

Copy()

Copy an existing CallParams object to a new CallParams object.

Declaration

public CallParams Copy()

Returns

Type	Description
CallParams	A copy of the CallParams object.

GetCustomHeader(String)

Get a custom SIP header.

Declaration

public string GetCustomHeader(string headerName)

Parameters

Type	Name	Description
System.String	headerName	The name of the header to get.

Returns

Type	Description
System.String	The content of the header or null if not found.

GetCustomSdpAttribute(String)

Get a custom SDP attribute that is related to all the streams.

Declaration

public string GetCustomSdpAttribute(string attributeName)

Parameters

Type	Name	Description
System.String	attributeName	The name of the attribute to get.

Returns

Type	Description
System.String	The content value of the attribute or null if not found.

GetCustomSdpMediaAttribute(StreamType, String)

Get a custom SDP attribute that is related to a specific stream.

Declaration

public string GetCustomSdpMediaAttribute(StreamType type, string attributeName)

Parameters

Type	Name	Description
StreamType	type	The type of the stream to add a custom SDP attribute to.
System.String	attributeName	The name of the attribute to get.

Returns

Type	Description
System.String	The content value of the attribute or null if not found.