Essentially we are creating a single meeting space with multiple access methods. ie the Speaker/Presenter will connect to the meeting space via a separate access method to a student or participant. It is through this means, we can apply or attach policies in the form of Call Leg Profiles, so when a student joins the meeting space we can have policy enforcing Mute Only for example.
Below it the process to creating a Lecture Only Room
Create the Call Leg Profiles
These profiles will determine what type of features or access the participants will have when they connect into a conference.
Presenter Call Leg Profile
POST /api/v1/calllegprofiles
Body
needsActivation = false
Name = Presenter
defaultLayout = allEqual
Guest – Muted Call Leg Profile
POST /api/v1/calllegprofiles
Body
needsActivation = true
Name = Guest – Muted
defaultLayout = speakerOnly
rxAudioMute = true
rxVideoMute = true
deactivationMode = deactivate
We need to retrieve both Call Leg Profile ID’s for use later.
GET /api/v1/calllegprofiles
Create the Meeting Space.
Now we create a space, name the space something meaningful and friendly to read.
POST /api/v1/cospaces
Body
Name = Class Meeting Space
Retrieve the Meeting Space ID
GET /api/v1/cospaces
Create the Access Methods
Once the space has been created, we will create two access methods (one for the Speaker or presenter and one for the students). We will attach the above created call leg profiles to their respective Access Method.
Access methods are appended to the cospace API string. Example.
https://cms_server.example.com.au:445/api/v1/cospaces/866aadfd-6ff4-43ca-ae0d-3aab6711c598/accessmethods
POST /api/v1/cospaces/cospace_ID/accessmethods
Included below is a Call ID, however you can also specify a SIP URI to call directly into this space, can also add passcode (PIN) to access to the meeting
Presenter Access Method
Body
callId = 1234
callLegProfile = 9a491602-851a-46c4-a2c9-9f144c1a53e9 (Presenter Call Leg Profile ID)
Guest – Muted Access Method
Body
Uri = guest.mute
callId = 5678
Passcode = 11111
callLegProfile = ed5834e4-c2fc-43b1-a703-2394b8e4d200 (Guest Call Leg Profile ID)
Now when a participant connects to the Meeting Space via the Call ID 1234, they will join the meeting without activation and be permitted to send/receive video/audio. However, if a participant connects to the Meeting Space using the Call ID 5678 (or the URI guest.mute@example.com.au), they will sit in the ‘Lobby’ until the presenter joins the meeting. When the participant does join into the meeting, their system will be muted for both video and audio. In addition, their screen will only ever show the active speaker.