Skip to main content
Version: 1.2.x

Room Class Events - Flutter


roomJoined

  • This event will be emitted when a localParticipant successfully joined the room.

Example

room.on(Events.roomJoined, (){
// do something
});

roomLeft

Example

room.on(Events.roomLeft, () {
// do something
});

participantJoined

  • This event will be emitted when a new participant joined the room.

Event handler parameters

Example

room.on(Events.participantJoined, (participant) {
// do something
});

participantLeft

  • This event will be emitted when a joined participant left the room.

Event handler parameters

Example

room.on(Events.participantLeft, (participant) {
// do something
});

speakerChanged

  • This event will be emitted when a active speaker changed.
  • If you want to know which participant is actively speaking, then this event will be used.
  • If no participant is actively speaking, then this event will pass null as an event handler parameter.

Event handler parameters

  • activeSpeakerId: String?

Example

room.on(Events.speakerChanged, (activeSpeakerId) {
// do something
});

presenterChanged

  • This event will be emitted when any participant starts or stops screen sharing.
  • It will pass participantId as an event handler parameter.
  • If a participant stops screen-sharing, then this event will pass null as en event handler parameter.

Event handler parameters

  • activePresenterId: String?

Example

room.on(Events.presenterChanged, (activePresenterId) {
// do something
});

pinStateChanged

  • This event will be emitted when any participant pin state gets changed.
  • It will pass participantId, state, and pinnedBy as Map<String, dynamic> as an event handler parameter.

Event handler parameters

  • data: Map{'<'}String{','} dynamic>{participantId:String, state:Map<String, dynamic>, pinnedBy:String}

Example

room.on(Events.pinStateChanged, (data) {
// do something
});

participantModeChanged

  • This event will be emitted when any participant mode gets changed.
  • It will pass participantId, and pinnedBy as Map<String, dynamic> as an event handler parameter.

Event handler parameters

  • data: Map<String, dynamic>{participantId:String, mode:String}

Example

room.on(Events.participantModeChanged, (data) {
// do something
});

entryRequested

  • This event will be emitted when a new participant, who is trying to join the room, is having permission ask_join in token.
  • This event will only be emitted to the participants in the room, who is having the permission allow_join in token.
  • This event will pass following parameters as an event parameters, participantId and name of the new participant who is trying to join the room, allow() and deny() to take required actions.

Event handler parameters

  • data: Map<String, dynamic>{ "allow": Function; "deny": Function; "name": String; "participantId": String }
    • allow: Function
    • deny: Function
    • name: String
    • participantId: String

Example

room.on(Events.entryRequested, (data){
String? participantId = data["participantId"];
String? name = data["name"];

Function allow = data["allow"];
Function deny = data["deny"];

print("$name requested to join the room.");

// If you want to allow the entry request
allow();

// if you want to deny the entry request
deny();
});

entryResponded

  • This event will be emitted when the join() request is responded.
  • This event will be emitted to the participants in the room, who is having the permission allow_join in token.
  • This event will be also emitted to the participant, who requested to join the room.

Event handler parameters

  • participantId: String
  • decision: "allowed" | "denied"

Example

room.on(Events.entryResponded, (participantId, decision) {
// participantId will be id of participant, who requested to join room

if (decision === "allowed") {
// entry allowed
} else {
// entry denied
}
});

cameraRequested

  • This event will be emitted to the participant B when any other participant A requests to enable camera of participant B.
  • On accepting the request, camera of participant B will be enabled.

Event handler parameters

  • data: Map<String, dynamic>{ accept: Function; participantId: String; reject: Function }
    • accept: Function
    • participantId: String
    • reject: Function

Example

room.on(Events.cameraRequested, (data) {
String? participantId = data["participantId"];

Function accept = data["accept"];
Function reject = data["deny"];

// participantId, will be the id of participant who requested to enable camera

// if accept request
accept();

// if reject request
reject();
});

micRequested

  • This event will be emitted to the participant B when any other participant A requests to enable mic of participant B.
  • On accepting the request, mic of participant B will be enabled.

Event handler parameters

  • data: Map<String, dynamic>{ accept: Function; participantId: String; reject: Function }
    • accept: Function
    • participantId: String
    • reject: Function

Example

room.on(Events.micRequested, (data) {
String participantId = data["participantId"];

Function accept = data["accept"];
Function reject = data["reject"];

// participantId, will be the id of participant who requested to enable camera

// if accept request
accept();

// if reject request
reject();
});

recordingStarted

This event will be deprecated soon

  • This event will be emitted when recording of the room is started.

Example

room.on(Events.recordingStarted, () {
// do something
});

recordingStopped

This event will be deprecated soon

  • This event will be emitted when recording of the room is stopped.

Example

room.on(Events.recordingStopped, () {
// do something
});

recordingStateChanged

  • This event will be emitted when the meeting's recording status changed.

Event callback parameters

  • status: String

status has following values

  • RECORDING_STARTING - Recording is in starting phase and hasn't started yet.
  • RECORDING_STARTED - Recording has started successfully.
  • RECORDING_STOPPING - Recording is in stopping phase and hasn't stopped yet.
  • RECORDING_STOPPED - Recording has stopped successfully.

Example

room.on(Events.recordingStateChanged, (String status) {
log("Meeting recording status : $status");
});

liveStreamStarted

This event will be deprecated soon

  • This event will be emitted when RTMP live stream of the room is started.

Example

room.on(Events.liveStreamStarted, () {
// do something
});

liveStreamStopped

This event will be deprecated soon

  • This event will be emitted when RTMP live stream of the room is stopped.

Example

room.on(Events.liveStreamStopped, () {
// do something
});

livestreamStateChanged

  • This event will be emitted when the meeting's livestream status changed.

Event callback parameters

  • status: String

status has following values

  • LIVESTREAM_STARTING - Livestream is in starting phase and hasn't started yet.
  • LIVESTREAM_STARTED - Livestream has started successfully.
  • LIVESTREAM_STOPPING - Livestream is in stopping phase and hasn't stopped yet.
  • LIVESTREAM_STOPPED - Livestream has stopped successfully.

Example

room.on(Events.liveStreamStateChanged, (String status) {
log("Meeting live streaming status : $status");
});

hlsStateChanged

  • This event will be emitted when the meeting's HLS(Http Livestreaming) status changed.

Event callback parameters

  • data: { status: String , playbackHlsUrl: String , livestreamUrl: String }
    • status: String
    • playbackHlsUrl: String will receive this property only in HLS_STARTED status
    • livestreamUrl: String will receive this property only in HLS_STARTED status

status has following values

  • HLS_STARTING - Hls is in starting phase and hasn't started yet.
  • HLS_STARTED - Hls has started successfully.
  • HLS_PLAYABLE - Hls has started can be played now, it will return playbaclHlsUrl and livestreamUrl.
  • HLS_STOPPING - Hls is in stopping phase and hasn't stopped yet.
  • HLS_STOPPED - Hls has stopped successfully.
note

downstreamUrl is now depecated. Use playbackHlsUrl or livestreamUrl in place of downstreamUrl

Example

room.on(Events.hlsStateChanged, (Map<String, dynamic> data) {
toastMsg("Meeting HLS status : ${data['status']}");
if (data['status'] == "HLS_PLAYABLE"){
// [data] : { status: String, playbackHlsUrl: String, livestreamUrl: String }
log("PLAYBACKHLS URL -- " + data['playbackHlsUrl']);
}
});

hlsStarted

This event will be deprecated soon

  • This event will be emitted when HLS of the meeting is started.

Event callback parameters

  • playbackHlsUrl: String
  • livestreamUrl: String

Example

room.on(Events.hlsStarted, (String playbackHlsUrl, String livestreamUrl) => {
//
});

hlsStopped

This event will be deprecated soon

  • This event will be emitted when HLS of the meeting is stopped.

Example

room.on(Events.hlsStopped, () => {
//
});


transcriptionStateChanged

  • This event will be triggered whenever state of realtime transcription is changed.

Event callback parameters

  • data: { status: String, id: String }
    • status: String
    • id: String

status has following values

  • TRANSCRIPTION_STARTING - Realtime Transcription is in starting phase and hasn't started yet.
  • TRANSCRIPTION_STARTED - Realtime Transcription has started successfully.
  • TRANSCRIPTION_STOPPING - Realtime Transcription is in stopping phase and hasn't stopped yet.
  • TRANSCRIPTION_STOPPED - Realtime Transcription has stopped successfully.

Example

room.on(Events.transcriptionStateChanged, (Map<String, dynamic> data) {
//Status can be :: TRANSCRIPTION_STARTING
//Status can be :: TRANSCRIPTION_STARTED
//Status can be :: TRANSCRIPTION_STOPPING
//Status can be :: TRANSCRIPTION_STOPPED
log("Meeting transcription status : ${data['status']}");
});

transcriptionText

  • This event will be emitted when text for running realtime transcription received.

Example

room.on(Events.transcriptionText, (TranscriptionText data) {
var participantId = data.participantId;
var participantName = data.participantName;
var text = data.text;
var timestamp = data.timestamp;
var type = data.type;
print(
"Meeting Transcription started. Participant name: $participantName , Participant Id $participantId ");

});

error

  • This event will be emitted when and error occurs in the room.

Example

room.on(Events.error, (error) {
log("VIDEOSDK ERROR :: " +
error['code'].toString() +
" :: " +
error['name'].toString() +
" :: " +
error['message'].toString());
});

whiteboardStarted

  • This event will be emitted when a whiteboard session is succesfully started.
  • It returns a URL that can be used to render the whiteboard in the app or in a web view.

Example

room.on(Events.whiteboardStarted, (url) {
// do something
});

whiteboardStopped

  • This event will be emitted when a whiteboard session succesfully ends.

Example

room.on(Events.whiteboardStopped, () {
// do something
});

Got a Question? Ask us on discord