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 is triggered when a participant's mode is updated.

It passes data as an event callback parameter, which includes the following:

  • SEND_AND_RECV: Both audio and video streams will be produced and consumed.

  • SIGNALLING_ONLY: Both audio and video streams will not be produced or consumed. It is used solely for signaling.

  • RECV_ONLY: Both audio and video streams will be consumed without producing any.

Event handler parameters​

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

Important Changes Flutter SDK in Version v1.3.0

  • The following modes have been deprecated:
    • CONFERENCE has been replaced by SEND_AND_RECV
    • VIEWER has been replaced by SIGNALLING_ONLY

Please update your implementation to use the new modes.

⚠️ Compatibility Notice:
To ensure a seamless meeting experience, all participants must use the same SDK version.
Do not mix version v1.3.0 + with older versions, as it may cause significant conflicts.

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
});

roomStateChanged​

  • This event is triggered whenever the room's state changes.
  • The current state of the room is passed as a callback parameter.
  • All available states are connecting, connected, failed, disconnected, closing, closed.

Event callback parameters​

  • state: RoomState

Example​

room.on(Events.roomStateChanged, (RoomState state) {
    switch (state) {
      case RoomState.connecting:
        print('Meeting is Connecting');
        break;
      case RoomState.connected:
        print('Meeting is Connected');
        break;
      case RoomState.disconnected:
        print('Meeting connection disconnected abruptly');
        break;
      case RoomState.failed:
        print('Meeting connection failed');
        break;
      case RoomState.closing:
        print('Meeting is closing');
        break;
      case RoomState.closed:
        print('Meeting connection closed');
        break;
      default:
        print('default');
    }
});

Got a Question? Ask us on discord

Last updated on by pavan901

Was this helpful?