error
Fires when an unrecoverable error ends the call. Aleft-meeting event fires immediately after.
Present when the error type is known. Always contains
type and msg. When type is 'connection-error', also includes a details object — see below.connection-error details
Whenerror.type is 'connection-error', an additional details object identifies where in the lifecycle the failure occurred:
Lifecycle stage where the failure occurred:
'load', 'join', 'reconnect', 'move', 'rtc-connection', or 'room-lookup'.nonfatal-error
Non-fatal errors are recoverable — the call continues after they fire. They signal that something went wrong in a specific subsystem but did not bring down the call. Use these to surface targeted warnings in your UI.input-settings-error
Fires when an error occurs while applying input settings changes.Either
'settings' (error while applying media settings) or 'processor' (error while setting up the processor).The underlying error. Contains a
camera-error-shaped object if the failure was getting user media, or the processor error if the failure was in the processor.live-streaming-warning
Fires when something went wrong with a live stream but the stream keeps running — for example an endpoint update the media server rejected (removing every endpoint, adding an HLS endpoint), or a single RTMP destination that stopped accepting media and was dropped. Live stream updates are applied asynchronously:addLiveStreamingEndpoints(), removeLiveStreamingEndpoints() and updateLiveStreaming() return once the request is sent. Watch this event to learn whether the change took effect. details carries the instanceId, an actionTraceId to quote when contacting support, and endpoints, the destinations the warning is about, when they are known. The same information is delivered server-side as the streaming.warning webhook.
An endpoint in details.endpoints is the streaming_endpoints name when the destination was given by name, otherwise the scheme://host[:port] of the RTMP URL. The full URL carries the stream key and is never sent. Any RTMP URL in warningMsg is reduced the same way.
local-audio-level-observer-error
Fires if an error occurs while the local audio level observer is running.meeting-session-data-error
Fires when an error occurs updating meeting session data viasetMeetingSessionData().
screen-share-error
Fires when an error occurs while starting a screen share.Either
'permissions' (user or OS blocked screen sharing) or 'unknown' (a getDisplayMedia() exception for another reason).Present when
category is 'permissions'. Either 'browser' (user denied access) or 'os' (OS is configured to block screen sharing).video-processor-warning
Fires when the user enables background effects in a browser where performance will likely be degraded — for example, when hardware graphics acceleration is disabled. This often correlates with very low frame rates on the outgoing video stream. This is powered by thefailIfMajorPerformanceCaveat WebGL property.