SignalingSession Class

Initializes a signaling session with endpoint and session target.

Creates a signaling session with a specified session ID.

Creates a new instances of SignalingSession with endpoint and the supplied settings.

Gets the session ID.

Gets the connection used by this signaling session. For incoming sessions, this property can be used to determine the address of the inviter. For outgoing sessions, this property can be used to retrieve information about the connection used. This property can return null if the connection does not exist at the moment.

Gets or sets the application's desired session timer interval (in seconds). This is used only for the initial invite or response.

Gets the endpoint associated with the session.

Gets the tag used in the "From" header. This property may return null if not available. For outgoing sessions, this property may not be available until the state is Alerted or Connected. For incoming sessions, the property may be available right away. This property can be null after the session is terminated. The application is responsible for caching the tag if it requires it after the session is disconnected.

Gets whether the session was initially received in the RealTimeEndpoint SessionReceived event.

Gets or sets the value indicating if the session supports a session timer. The default value of this property is inherited from the endpoint. An application can override this property per session. If the session is already using a session timer, this flag will only affect the behavior when the next session refresh occurs. If the flag is turned on after the session is connected, the application needs to call ReNegotiateMediaDescription to enable the session timer.

Gets the local participant of the session. This is helpful to get the URI of the local participant which can differ from the URI of the endpoint, particularly for incoming sessions.

Gets the minimum session expires interval value (in seconds) currently used by this session.

Gets or sets the offer answer negotiation callback interface implemented by the caller.

Gets or sets the default policy for supporting 100rel extension feature. If an application supports this then the remote can ask for this when sending provisional responses which will result in a PRACK message getting sent to acknowledge the response. An application should set this before sending Invite or else it may not have any effect.

Gets the remote participant of the session.

Gets the status of the dialog's route set.

Gets the target of this session.

Gets the session timer interval (in seconds) currently used.

Gets the state of this session.

Gets the tag used in the "To" header. This property might return null if not available. For both outgoing and incoming sessions, this property may not available until the session is connected. This property can be null after the session is terminated. The application is responsible for caching the tag if it requires it after the session is disconnected.

Accept the session.

Accept the session with options specified.

Establish the session.

Establish the session with options specified.

Participates in a session. This method needs to be called (for both outgoing and incoming messages) to establish the session.

Participates in a session. This method needs to be called (for both outgoing and incoming messages) to establish the session.

Refers a URI to the remote participant.

Refers a URI to the remote participant.

Refers a URI to the remote participant.

Renegotiates the media description. Only one negotiation can be outstanding at any time. The session should be in the Connected state for this method to work.

Renegotiates the media description with the specified participant. Only one negotiation can be outstanding with any participant at any time. The participant should be part of the session for this method to succeed. The participant cannot be a local participant. A given topology may not allow the exchange of descriptions with certain participants.

Renegotiates the media description. Only one negotiation can be outstanding at any time. The session should be in the Connected state for this method to work.

Sends a message. The session should be in the Connected state.

Send message to participant specified. Participant who is not part of the session is ignored.

Sends a provisional response.

Sends a provisional response.

This method can be used to send a reliable provisional response with option to send answer for early media. If the inviter supports 100rel and the local policy is not unsupported, this method will wait for the PRACK. Otherwise, this method will not require 100rel. Any application that supports 100rel is recommended to use this method for sending provisional response. SendProvisional method can be used only when the application knows for sure that the remote does not require 100rel.

This method can be used to send a reliable provisional response with option to send answer for early media. If the inviter supports 100rel and the local policy is not unsupported, this method will wait for the PRACK. Otherwise, this method will not require 100rel. Any application that supports 100rel is recommended to use this method for sending provisional response. SendProvisional method can be used only when the application knows for sure that the remote does not require 100rel.

Terminates the session asynchronously. The session will be no longer usable.

Terminates the session asynchronously. The session will be no longer usable.

Waits for the pending accept operation to complete.

Waits for the pending establish operation to complete.

Waits for the pending participate operation to complete.

Waits for the pending refer operation to complete.

Waits for the pending renegotiate operation to complete.

Waits for the pending SendMessage operation to complete.

Waits for the send provisional operation to complete.

Waits for the pending SendProvisionalResponse operation to complete.

Completes the pending Terminate operation.

Creates a new dialog context.

Gets the trace correlation id for this instance.

Synchronously participates in a session. This method is not recommended for UI threads or scalable server applications.

Synchronously participates in a session. This method is not recommended for UI threads or scalable server applications.

Synchronously transfers the current session to a different real-time address. This method will wait until the transfer is completed. It is not recommended for a UI thread.

Synchronously transfers the current session to a different real-time address. This method will wait until the transfer is completed. It is not recommended for a UI thread.

Synchronously renegotiates the media description. This method will wait until the media description is renegotiated. It is not recommended for a UI thread.

Synchronously renegotiates the media description. This method will wait until the media description is renegotiated. It is not recommended for a UI thread.

Synchronously sends a message. The session should be in the Connected state. This method is not recommended for a UI thread.

Synchronously sends a message. The session should be in the Connected state. This method is not recommended for a UI thread.

Sends a provisional response synchronously.

Sends a provisional response synchronously with optional support for early media.

Sends a provisional response synchronously with optional support for early media.

Synchronously terminates the session.

Synchronously terminates the session.

Terminates an incoming session by redirecting (with response code 302) the inviter with a list of addresses.

Terminates an incoming session by redirecting the inviter (with specific redirect response code given) with a list of addresses.

Terminates an incoming session by redirecting the inviter with an address.

Terminates a session by rejecting the incoming invite. This method can be called only for an incoming session before participating in it.

Tries to cancel a pending renegotiation. Returns if cancel is either sent or setup to be sent. This method does not guarantee that renegotiation will not receive a final response since there is possibility that a final response is on the way before cancel message can reach the remote.

Tries to cancel a pending renegotiation. Returns if cancel is either sent or setup to be sent. This method does not guarantee that renegotiation will not receive a final response since there is possibility that a final response is on the way before cancel message can reach the remote.

Raised when the remote has accepted the invite. Typically, this happens when a successful response is received. This event is optional for an application. Applications that want to send headers in the acknowledgement can register for this event.

Raised when the invite process completes. Typically, this happens when the inviter acknowledges a successful response. This event is optional for an application. Applications that want to access headers in the acknowledgement can register for this event. Note that EndParticipate for the incoming side also exposes the Ack message. This event is provided for convenience.

Raised when a message is received.

Raised when the session received any provisional response (101-199).

Raised when a redirect request is received.

Raised when a new Refer is received.

Raised when the remote sends a re-invite. This event is optional for an application. Applications that want to access headers in the re-invite can register for this event.

Raised when the session is enabled for a session timer, the local endpoint is the refresher, and the remote does not support the
UPDATE method. The application is responsible for calling BeginRenegotiateDescription to keep the session alive.

Raised when a request or response is received.

Raised when the state of the route set of the session changes.

Raised when the state of the session changes.

Raised when the remote side terminates the session by sending a Bye or Cancel message. This event is optional for an application. This event is useful only if the application is interested in accessing the headers in the Bye or Cancel message for custom scenarios.