Joining and Leaving Conferences
This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.
After a local user schedules a conference on a Focus, the user must invite other users and then join the new conference. To join the newly scheduled conference, a user must have obtained a conference Focus URI for the active conference Focus. To invite a remote user to dial in to the new conference, a local conference inviter must provide the remote user with the conference Focus URI in a conference invitation. The conference creator obtains the URI when the local client handles the OnScheduleConference event. For information about inviting remote users to a conference, see Invite Users to a Conference.
The process of joining a conference is discussed in this section and illustrated using an audio conference example.
It is important to note that a single conference consists of an instance of IUccConferenceSession and an additional media session representing an MCU attached to the conference. The local user must be added to both of these sessions. The conference Focus is the remote participant of the IUccConferenceSession instance and a conference MCU is the remote participant of the media session. For information about connecting to conference MCU, see Obtain Conference Media.
An example is an IM conference that consists of two sessions. The first is the IUccConferenceSession and the second is an instance of IUccInstantMessagingSession where the remote participant is the IM MCU itself. If the conference presenter wants to add audio/video to this IM conference, each client must create a new audio/video session where the remote participant is an A/V MCU. After adding audio/video to an IM conference, each client now has three active sessions presenting the conference: IUccConferenceSession, IUccInstantMessagingSession, and IUccAudioVideoSession. The conference Focus or one of the conference MCUs is the remote participant in each of these sessions.
To join a conference, a Unified Communications Client API application needs to:
- Create an instance of IUccSession of type UCC_SESSION_TYPE.UCCST_CONFERENCE
- Submit an Enter request to join the conference. This method takes the conference URI as a string parameter.
- Create a new modality-specific session, using the modality conference MCU as the remote participant.
- Configure the endpoint media channels originating from the conference Focus. Note that your client does not configure media channels for an IM conference as the Focus does not require a media channel for IM.
- Enable the participant to participate in the conference using the provided conference media.
- Terminate the media session, leave the conference on behalf of the participant, or both.
The following sections illustrate these tasks.