InstantMessagingCall Class
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
InstantMessagingCall is the class that supports instant messaging-based communication.
public ref class InstantMessagingCall : Microsoft::Rtc::Collaboration::Callpublic class InstantMessagingCall : Microsoft.Rtc.Collaboration.Calltype InstantMessagingCall = class
inherit CallPublic Class InstantMessagingCall
Inherits Call- Inheritance
Remarks
Instant messaging communication is realtime, text-based communication. InstantMessagingCall is an implementation of the abstract Call class. It implements signaling for instant messaging calls. Actual text messages are exchanged on an instance of InstantMessagingFlow, which is created at the time when the call is established.
Constructors
| InstantMessagingCall(Conversation) |
Creates a new instance of the InstantMessagingCall class. |
Properties
| ActiveMediaTypes |
Obsolete.
Gets the list of active media types for the call. (Inherited from Call) |
| ApplicationContext |
Gets or sets an application-defined context. (Inherited from Call) |
| CallId |
Gets the CallId of the primary SIP session used by the call. (Inherited from Call) |
| CanBeDeflected |
Gets whether this call can be deflected to a destination URI other than given destination URI. (Inherited from Call) |
| CanHandleTransferReceived |
Gets whether the application supports handling of incoming transfer requests. (Inherited from Call) |
| Conversation |
Gets the conversation that contains this call. (Inherited from Call) |
| DefaultMediaType |
Gets the default media type for this call. |
| Flow |
Gets an InstantMessagingFlow for this call. |
| IsEarlyMediaSupported |
Gets whether the call supports the reliable provisional response for early media. (Inherited from Call) |
| IsImmediateAutoAcceptNeeded |
Gets whether the call should be automatically accepted. immediately upon receipt. |
| IsReplacesSupported |
Gets whether the local endpoint supports the call replacement feature. (Inherited from Call) |
| IsThirdPartyCallControl |
Gets whether the call is used in a third-party call control scenario. (Inherited from Call) |
| IsUsingGeneratedIdentity |
Gets whether the call should use a generated identity during call establishment to a trusted conference. (Inherited from Call) |
| LocalTag |
Gets the local tag of the primary session. (Inherited from Call) |
| OriginalDestinationUri |
Gets the original destination URI of the call. (Inherited from Call) |
| RemoteEndpoint |
Gets the remote endpoint of the call. (Inherited from Call) |
| RemoteEndpointProperties |
Gets the call-specific properties of the remote participant endpoint of this call. (Inherited from Call) |
| RemoteTag |
Gets the remote tag of the primary session. (Inherited from Call) |
| RouteSetStatus |
Gets the status of the dialog's route set. (Inherited from Call) |
| State |
Gets the current state of the call. (Inherited from Call) |
| SupportedMediaTypes |
Gets the list of supported Media names, which are acceptable m-lines in SDP offer/answer. |
Methods
| BeginAccept(AsyncCallback, Object) |
Accepts an incoming call. (Inherited from Call) |
| BeginAccept(CallAcceptOptions, AsyncCallback, Object) |
Accepts an incoming call with given options. (Inherited from Call) |
| BeginEstablish(AsyncCallback, Object) |
Establishes an outgoing call. (Inherited from Call) |
| BeginEstablish(CallEstablishOptions, AsyncCallback, Object) |
Establishes an outgoing call with given options. (Inherited from Call) |
| BeginEstablish(String, CallEstablishOptions, AsyncCallback, Object) |
Establishes an outgoing call. (Inherited from Call) |
| BeginEstablish(String, ToastMessage, CallEstablishOptions, AsyncCallback, Object) |
Begins the operation of establishing the instant messaging call with the remote participant. |
| BeginEstablish(ToastMessage, CallEstablishOptions, AsyncCallback, Object) |
Begins the operation of establishing the instant messaging call on existing Conversation. |
| BeginHandleTermination(AsyncCallback, Object) |
Handles termination in a class derived from the call class. (Inherited from Call) |
| BeginSendInfo(ContentType, Byte[], IEnumerable<SignalingHeader>, AsyncCallback, Object) |
Obsolete.
Sends an INFO message to the remote participant of this call. (Inherited from Call) |
| BeginSendMessage(MessageType, ContentType, Byte[], IEnumerable<SignalingHeader>, AsyncCallback, Object) |
Send a message to the remote participant specified. (Inherited from Call) |
| BeginSendReliableProvisionalResponse(Int32, Boolean, CallProvisionalResponseOptions, AsyncCallback, Object) |
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. (Inherited from Call) |
| BeginTerminate(AsyncCallback, Object) |
Terminates the call. After the call is terminated it is no longer usable. (Inherited from Call) |
| BeginTerminate(CallTerminateOptions, AsyncCallback, Object) |
Terminates the call. After the call is terminated it is no longer usable. (Inherited from Call) |
| BeginTerminate(IEnumerable<SignalingHeader>, AsyncCallback, Object) |
Terminates the call. After the call is terminated it is no longer usable. (Inherited from Call) |
| BeginTransfer(Call, CallTransferOptions, AsyncCallback, Object) |
Initiates a transfer request to the remote participant of the current call to replace another existing call in Attended type. (Inherited from Call) |
| BeginTransfer(String, CallTransferOptions, AsyncCallback, Object) |
Initiates a transfer request to the remote participant to transfer the current call to the given transfer target in Attended or Unattended type. (Inherited from Call) |
| BindMediaProvider(MediaProvider) |
Binds a user-specified media provider to the call. (Inherited from Call) |
| Decline() |
Declines an incoming call with a 603 response code (DeclineEverywhere). (Inherited from Call) |
| Decline(CallDeclineOptions) |
Declines an incoming call with options. (Inherited from Call) |
| EndAccept(IAsyncResult) |
Determines whether the corresponding operation completed successfully. This method will wait if the operation has not yet completed (Inherited from Call) |
| EndEstablish(IAsyncResult) |
Determines whether the corresponding operation completed successfully. This method will wait if the operation has not yet completed. (Inherited from Call) |
| EndHandleTermination(IAsyncResult) |
This method is used to determine whether the corresponding operation completed successfully. This method will wait if the operation has not yet completed. (Inherited from Call) |
| EndSendInfo(IAsyncResult) |
Obsolete.
Determines whether the corresponding operation completed successfully. This method will wait if the operation has not yet completed. (Inherited from Call) |
| EndSendMessage(IAsyncResult) |
This method is used to determine whether the corresponding operation completed successfully. This method will wait if the operation has not yet completed (Inherited from Call) |
| EndSendReliableProvisionalResponse(IAsyncResult) |
This method is used to determine whether the corresponding operation completed successfully. This method will wait if the operation has not yet completed (Inherited from Call) |
| EndTerminate(IAsyncResult) |
Determines whether the corresponding operation completed successfully. This method will wait if the operation has not yet completed. (Inherited from Call) |
| EndTransfer(IAsyncResult) |
This method is used to determine whether the corresponding operation completed successfully. This method will wait if the operation has not yet completed (Inherited from Call) |
| Forward(String, CallForwardOptions) |
Forwards the call to a different target URI with given options. (Inherited from Call) |
| Forward(String) |
Forwards the call to the specified target URI with a response code of 303. (Inherited from Call) |
| GetActiveMediaTypes() |
Gets the active media types for the call. (Inherited from Call) |
| GetMediaForDialReplaces() |
Gets the enumeration of media types that MCU should offer when dialing or replacing this call. (Inherited from Call) |
| GetNewEarlyDialog() |
Returns the dialog context for the new early dialog. (Inherited from Call) |
| GetTraceCorrelationID() |
Gets the trace correlation id for this instance. (Inherited from Call) |
| HandleCallMessageReceived(CallMessageReceivedEventArgs) |
Handles a message received event in a class derived from the call class. (Inherited from Call) |
| HandleFlowConfigurationRequested(MediaFlow) |
Handles the FlowConfigurationRequested event raising. |
| HandleForwardReceived(CallForwardReceivedEventArgs) |
Handles the forward response. |
| HandleMessageReceived(MessageReceivedEventArgs) |
Obsolete.
Handles a message received event in a class derived from the call class. (Inherited from Call) |
| HandleStateChange(CallStateChangedEventArgs) |
Indicates a state change to the derived call. |
| HandleTransferNotificationReceived(TransferStateChangedEventArgs) |
Handles the received notifications. |
| HandleTransferReceived(CallTransferReceivedEventArgs) |
Handles the transfer received event. |
| IsSupportedMediaType(String) |
Determines whether the given media type is present in the list of supported media types. (Inherited from Call) |
| MakeCallback(AsyncCallback, IAsyncResult) |
Invokes a specified call using the application's queue for the events. (Inherited from Call) |
| ProcessIncomingInviteHeaders(IEnumerable<SignalingHeader>) |
Checks the interesting headers for the call and initializes the needed call properties. |
| RaiseEvent<TEventArg>(EventHandler<TEventArg>, Object, TEventArg) |
Raises a generic event with a specific event argument type to the application (Inherited from Call) |
| SendProvisionalResponse(Int32, CallProvisionalResponseOptions) |
Sends a provisional response synchronously. (Inherited from Call) |
| UnbindMediaProvider() |
Removes the currently bound media provider. BindMediaProvider(MediaProvider) (Inherited from Call) |
Events
| AutoAcceptNeeded |
Raised when the call needs to be automatically accepted by the application. |
| ConversationChanged |
Raised when this call is moved to a derived conversation. (Inherited from Call) |
| InfoReceived |
Obsolete.
Raised when an INFO message is received on this call. (Inherited from Call) |
| InstantMessagingFlowConfigurationRequested |
Raised when InstantMessagingFlow is created. Applications can use this event handler to register for flow related event handlers and optionally set flow configuration. |
| ProvisionalResponseReceived |
Raised when a provisional response is received for an outgoing INVITE. (Inherited from Call) |
| RemoteParticipantChanged |
Raised when the remote participant that accepted this call cannot be verified as matching the original participant invited. (Inherited from Call) |
| RouteSetStatusChanged |
Raised when the state of the route set of the call changes. (Inherited from Call) |
| StateChanged |
Raised when the state of the call changes. (Inherited from Call) |