McuSession.StateChanged Event

Definition

Namespace:

Microsoft.Rtc.Collaboration

Assembly:

Microsoft.Rtc.Collaboration.dll

Raised when the MCU state changes are reported back to the application.

public:
 event EventHandler<Microsoft::Rtc::Signaling::StateChangedEventArgs<Microsoft::Rtc::Collaboration::McuSessionState> ^> ^ StateChanged;

public event EventHandler<Microsoft.Rtc.Signaling.StateChangedEventArgs<Microsoft.Rtc.Collaboration.McuSessionState>> StateChanged;

member this.StateChanged : EventHandler<Microsoft.Rtc.Signaling.StateChangedEventArgs<Microsoft.Rtc.Collaboration.McuSessionState>> 

Public Custom Event StateChanged As EventHandler(Of StateChangedEventArgs(Of McuSessionState)) 

Event Type

EventHandler<StateChangedEventArgs<McuSessionState>>

Remarks

When the first participant joins a conference, the MCU activation process is started on the server. When the MCU becomes active, and the state is communicated back to the application, the McuSession state is transitioned from Idle to Active. Note that it is not guranteed an McuSession becomes active before ConferenceSession completes the join operation. Any McuSession operation invoked on an idle but bound McuSession shall be queued and resumed after 30 seconds or before that if the MCU becomes active.

If the ConferenceSession joins a conference that does not support the corresponding MCU type, tthe state will be transitioned to Terminated before the join operation completes.

If the MCU fails over to another front end and the conference focus communicates the fail-over state back to the application, the McuSession state will be transitioned from Active to Retrying. If a Call was already established to that failing MCU, the Call will be terminated and the application should establish a new Call if required. After the MCU fail-over process is completed and the focus communicates activation to the application, the McuSession state will be transitioned from Retrying to Active.

The McuSession state will also be transitioned to Retrying while the parent ConferenceSession is reconnecting to the focus as a result of the focus failing over to another front end. The McuSession will be transitioned back to Idle or Active based on the MCU state communicated back to the application.