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
Room
object.
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