Floor Access Control

In Lecture Mode, only the moderator publishes a stream. Participants must request floor access to publish their audio or video. The Android SDK provides methods to request, grant, deny, release, and invite participants to the floor, giving the moderator full control over who speaks.

Request Floor Access

EnxRoom.requestFloor() lets a participant send a floor access request to the moderator. The participant receives an acknowledgment when the moderator receives the request, and the moderator is notified separately.

• Class: EnxRoom
• Method: public void requestFloor()
• Observer: room.setChairControlObserver(this)
• Participant only (moderators cannot request floor access)

room.setChairControlObserver(this);
room.requestFloor();

public void onFloorRequested(JSONObject jsonObject) {
    // Your floor request was received by the moderator
}

public void onFloorRequestReceived(JSONObject jsonObject) {
    // Moderator: a participant has requested floor access
}

Cancel a Floor Request

EnxRoom.cancelFloor() allows a participant to withdraw a pending floor access request before the moderator has responded.

• Class: EnxRoom
• Method: public void cancelFloor()
• Participant only

room.cancelFloor();

public void onFloorCancelled(JSONObject jsonObject) {
    // Your floor request was cancelled
}

public void onCancelledFloorRequest(JSONObject jsonObject) {
    // Moderator: participant cancelled their floor request
}

Grant Floor Access

EnxRoom.grantFloor(String clientId) gives floor access to a specific participant, allowing them to publish their stream. This method is available to the moderator only. Only one participant can hold floor access at a time — release the current holder's floor before granting to another.

• Class: EnxRoom
• Method: public void grantFloor(String clientId)
• Parameter: clientId — the client ID of the participant to grant floor access.
• Moderator only: Yes

room.grantFloor(clientId);

public void onProcessFloorRequested(JSONObject jsonObject) {
    // Moderator: floor granted to participant
}

public void onGrantedFloor(JSONObject jsonObject) {
    // Participant: you have floor access — publish your stream
    room.publish(localStream);
}

Deny Floor Access

EnxRoom.denyFloor(String clientId) rejects a participant's floor access request. The moderator receives an acknowledgment and the participant is notified that their request was denied.

• Class: EnxRoom
• Method: public void denyFloor(String clientId)
• Parameter: clientId — the client ID of the participant whose request is being denied.
• Moderator only: Yes

room.denyFloor(clientId);

public void onProcessFloorRequested(JSONObject jsonObject) {
    // Moderator: floor request denied
}

public void onDeniedFloorRequest(JSONObject jsonObject) {
    // Participant: your floor request was denied
}

Finish Floor Access

EnxRoom.finishFloor() lets a participant announce that they are done speaking and voluntarily release the floor. All moderators are notified.

• Class: EnxRoom
• Method: public void finishFloor()
• Participant only

room.finishFloor();

public void onFloorFinished(JSONObject jsonObject) {
    // Your floor access has ended
}

public void onFinishedFloorRequest(JSONObject jsonObject) {
    // Moderator: participant finished floor access
}

Release Floor Access

EnxRoom.releaseFloor(String clientId) allows the moderator to forcibly revoke floor access from a participant. All participants are notified when floor access is released.

• Class: EnxRoom
• Method: public void releaseFloor(String clientId)
• Parameter: clientId — the client ID of the participant whose floor access is being revoked.
• Moderator only: Yes

room.releaseFloor(clientId);

public void onProcessFloorRequested(JSONObject jsonObject) {
    // Moderator: floor released from participant
}

public void onReleasedFloorRequest(JSONObject jsonObject) {
    // Participant: your floor access has been revoked
}

Restore Moderator Session

If the moderator reconnects after a disconnection, retrieve the current floor state from room metadata so pending and active requests can be resumed:

• room.getRoomMetaData().getJSONArray("raisedHands") — client IDs of participants with pending floor requests.
• room.getRoomMetaData().getJSONArray("approvedHands") — client IDs of participants currently holding floor access.

These methods give the moderator additional control — instead of waiting for participants to request floor access, the moderator can proactively invite participants to speak.

Invite a Participant to the Floor

EnxRoom.inviteToFloor(String clientId) lets the moderator invite any participant to take the floor without waiting for a request. The invited participant receives a notification and can accept or reject the invitation.

• Class: EnxRoom
• Method: public void inviteToFloor(String clientId)
• Parameter: clientId — the client ID of the participant to invite.
• Moderator only: Yes

EnxRoom.inviteToFloor(clientId);

@Override
public void onACKInviteToFloorRequested(JSONObject jsonObject) {
    // Moderator: invitation sent
}

@Override
public void onInviteToFloorRequested(JSONObject jsonObject) {
    // All moderators notified
}

@Override
public void onInvitedForFloorAccess(JSONObject jsonObject) {
    // Participant: you have been invited to speak
}

Cancel a Floor Invitation

EnxRoom.cancelFloorInvite(String clientId) allows the moderator to withdraw an outstanding floor invitation before the participant has accepted or rejected it. The invited participant and all other moderators are notified.

• Class: EnxRoom
• Method: public void cancelFloorInvite(String clientId)
• Parameter: clientId — the client ID of the participant whose invitation is being cancelled.
• Moderator only: Yes

EnxRoom.cancelFloorInvite(clientId);

@Override
public void onProcessFloorRequested(JSONObject jsonObject) {
    // Moderator: invitation cancelled
}

@Override
public void onCanceledFloorInvite(JSONObject jsonObject) {
    // Participant notified: invitation cancelled
}

Accept a Floor Invitation

EnxRoom.acceptInviteFloorRequest(String clientId) lets a participant accept the moderator's floor invitation. All moderators are notified when the participant accepts.

• Class: EnxRoom
• Method: public void acceptInviteFloorRequest(String clientId)
• Parameter: clientId — the client ID of the moderator who sent the invitation.
• Participant only (moderators cannot accept their own invitations)

EnxRoom.acceptInviteFloorRequest(clientId);

@Override
public void onProcessFloorRequested(JSONObject jsonObject) {
    // Participant: floor invitation accepted
}

@Override
public void onAcceptedFloorInvite(JSONObject jsonObject) {
    // Moderators notified: participant accepted
}

Reject a Floor Invitation

EnxRoom.rejectInviteFloor(String clientId) lets a participant decline the moderator's floor invitation. All moderators are notified of the rejection.

• Class: EnxRoom
• Method: public void rejectInviteFloor(String clientId)
• Parameter: clientId — the client ID of the moderator who sent the invitation.
• Participant only (moderators cannot reject their own invitations)

EnxRoom.rejectInviteFloor(clientId);

@Override
public void onProcessFloorRequested(JSONObject jsonObject) {
    // Participant: floor invitation rejected
}

@Override
public void onRejectedInviteFloor(JSONObject jsonObject) {
    // Moderators notified: participant rejected
}