Error Events - Flutter
VideoSDK provides the error event which informs you about any error happening during the meeting.
Events.error
- This event is triggered whenever an invalid configuration is provided or server/network errors arise. In such cases, the event will trigger with a specific error code and message.
- It is particularly useful for development-level troubleshooting during SDK integration.
- It can be subscribed to using the
Roomobject.
Example
Here is an example demonstrating the usage of the event mentioned on this page.
import 'dart:developer';
import 'package:flutter/material.dart';
import 'package:videosdk/videosdk.dart';
class MeetingScreen extends StatefulWidget {
//Existing configuration
}
class _MeetingScreenState extends State<MeetingScreen> {
late Room room;
@override
void initState() {
//Existing configuration
setupRoomEventListener();
}
@override
Widget build(BuildContext context) {
return YourMeetingWidget();
}
void setupRoomEventListener() {
room.on(Events.error, (error) {
log("VIDEOSDK ERROR :: ${error['code']} :: ${error['name']} :: ${error['message']}");
});
}
}
Error Codes
We have depicted a specific constant with code and message in the below table.
| Constant | Code | Message |
|---|---|---|
| INVALID_API_KEY | 4001 | apikey provided in the token is empty or invalid, please verify it on the dashboard. |
| INVALID_TOKEN | 4002 | token is empty or invalid or might have expired. |
| INVALID_MEETING_ID | 4003 | meetingId is empty or invalid, please verify it or generate new meetingId using the API. |
| INVALID_PARTICIPANT_ID | 4004 | participantId is empty or invalid, it shouldn't contain any whitespaces. |
| DUPLICATE_PARTICIPANT | 4005 | Leaving meeting, since this participantId joined from another device. |
| ACCOUNT_DEACTIVATED | 4006 | It seems your account is deactivated by VideoSDK for some reason, you can reach out to us at support@videosdk.live. |
| ACCOUNT_DISCONTINUED | 4007 | _Server will respond you with specific message. |
| INVALID_PERMISSIONS | 4008 | permissions provided in the token are invalid, please don't use allow_join or allow_mod with ask_join. |
| MAX_PARTICIPANT_REACHED | 4009 | You have reached max participant limit in a meeting. |
| MAX_SPEAKER_REACHED | 4010 | You have reached max speaker limit in a meeting. |
| START_RECORDING_FAILED | 4011 | Recording start request failed due to an unknown error. |
| STOP_RECORDING_FAILED | 4012 | Recording stop request failed due to an unknown error. |
| START_LIVESTREAM_FAILED | 4013 | Livestream start request failed due to an unknown error. |
| STOP_LIVESTREAM_FAILED | 4014 | Livestream stop request failed due to an unknown error. |
| INVALID_LIVESTREAM_CONFIG | 4015 | Livestream 'outputs' configuration provided was invalid. |
| START_HLS_FAILED | 4016 | HLS start request failed due to an unknown error. |
| STOP_HLS_FAILED | 4017 | HLS stop request failed due to an unknown error. |
| PREV_RECORDING_PROCESSING | 4018 | Previous recording session is being processed, please try again after few seconds! |
| PREV_RTMP_RECORDING_PROCESSING | 4019 | Previous RTMP recording session is being processed, please try again after few seconds! |
| PREV_HLS_STREAMING_PROCESSING | 4020 | Previous HLS streaming session is being processed, please try again after few seconds! |
| ADD_ON_SERVICES_DISABLED | 4021 | Add-On services are disabled for your account! Please contact us at support@videosdk.live. |
| UNAUTHORIZED_MEETING_ID | 4022 | You have reached max speaker limit on organization. To increase contact at support@videosdk.live". |
| UNAUTHORIZED_PARTCIPANT_ID | 4023 | You have reached max speaker limit on organization. To increase contact at support@videosdk.live". |
| MAX_SPEAKER_LIMIT_REACHED_ON_ORGANIZATION | 4024 | You have reached max speaker limit on organization. To increase contact at support@videosdk.live". |
| MAX_SPEAKER_LIMIT_REACHED_ON_ORGANIZATION | 4025 | You have reached max speaker limit on organization. To increase contact at support@videosdk.live". |
| MAX_SPEAKER_LIMIT_REACHED_ON_ORGANIZATION | 4026 | You have reached max speaker limit on organization. To increase contact at support@videosdk.live". |
| MAX_VIEWER_LIMIT_REACHED_ON_ORGANIZATION | 4027 | You have reached max viewer limit on organization. To increase contact at support@videosdk.live". |
| MAX_RECORDING_LIMIT_REACHED_ON_ORGANIZATION | 4028 | You have reached max limit of recording on organization. To increase contact at support@videosdk.live. |
| MAX_HLS_LIMIT_REACHED_ON_ORGANIZATION | 4029 | You have reached max limit of hls on organization. To increase contact at support@videosdk.live. |
| MAX_LIVESTREAM_LIMIT_REACHED_ON_ORGANIZATION | 4030 | You have reached max limit of livestream on organization. To increase contact at support@videosdk.live. |
| START_TRANSCRIPTION_FAILED | 4031 | Transcription start request failed due to an unknown error. |
| STOP_TRANSCRIPTION_FAILED | 4032 | Transcription stop request failed due to an unknown error. |
| RECORDING_FAILED | 5001 | Recording stopped due to an unknown error. |
| LIVESTREAM_FAILED | 5002 | Livestream stopped due to an unknown error. |
| HLS_FAILED | 5003 | HLS stopped due to an unknown error. |
| RECORDING_DURATION_LIMIT_REACHED | 5004 | Recording has been automatically stopped by the system, due to max duration limit of 2 hours reached for a single Recording |
| LIVESTREAM_DURATION_LIMIT_REACHED | 5005 | Livestream has been automatically stopped by the system, due to max duration limit of 2 hours reached for a single RTMP |
| HLS_DURATION_LIMIT_REACHED | 5006 | Hls has been automatically stopped by the system, due to max duration limit of 2 hours reached for a single HLS |
| TRANSCRIPTION_FAILED | 5007 | Transcription stopped due to an unknown error. |
| ERROR_STARTING_VIDEO_MEDIA | 3011 | Some error occurred during starting the video |
| ERROR_STARTING_AUDIO_MEDIA | 3012 | Some error occurred during starting the audio |
| ERROR_STARTING_SCREENSHARE | 3013 | Some error occurred during starting the screen share |
| ERROR_GET_DISPLAY_MEDIA_PERMISSION_DENIED | 3014 | Screen sharing permission denied |
| ERROR_GET_DISPLAY_MEDIA_NOT_SUPPORTED | 3015 | Screen share feature not supported |
API Reference
The API references for all the methods and events utilized in this guide are provided below.
Got a Question? Ask us on discord

