These events fire when the camera starts or encounters an error, when input or output devices change, and when media send/receive settings are updated.
started-camera Fires when the local participant’s camera starts. This happens as part of the standard join flow, or when explicitly calling startCamera()
// Example event object { "action" : "started-camera" , "callClientId" : "17225364729060.9442072768918943" }
camera-error Fires when a camera or microphone error occurs. The error.type field categorizes the problem; error.msg is a human-readable description.
The ID of the call client instance that emitted this event.
Always contains type and msg. Some types include additional fields. "not-found"
DailyCamDeviceNotFoundError
Camera and/or microphone not detected.
missingMedia — Array<'video' | 'audio'> — which devices were not found { "type" : "not-found" , "msg" : "No device found." , "missingMedia" : [ "video" , "audio" ] }
User or browser blocked camera/microphone access.
blockedBy — 'user' or 'browser'blockedMedia — Array<'video' | 'audio'> — which devices were blocked { "type" : "permissions" , "msg" : "Permissions denied to the browser." , "blockedBy" : "browser" , "blockedMedia" : [ "video" , "audio" ] }
"cam-in-use" | "mic-in-use" | "cam-mic-in-use"
Camera and/or microphone in use by another application. Windows only. { "type" : "cam-in-use" , "msg" : "Camera in use by another application." }
getUserMedia() was called with invalid or empty constraints.
reason — 'invalid' or 'none-specified'failedMedia — Array<'video' | 'audio'> — which devices were affected { "type" : "constraints" , "msg" : "Invalid constraints provided." , "reason" : "invalid" , "failedMedia" : [ "video" ] }
window.navigator.mediaDevices is undefined. Most commonly caused by accessing the call over http instead of https.{ "type" : "undefined-mediadevices" , "msg" : "navigator.mediaDevices is undefined. Check url for https." }
Uncategorized error. The original browser error message is in msg. { "type" : "unknown" , "msg" : "Unknown device error (NotReadableError)" }
errorMsg
string | object
deprecated
Retained for backwards compatibility.
call . on ( 'camera-error' , ({ error }) => { if ( error ?. type === 'permissions' ) { showPermissionsPrompt ( error . blockedBy ); } else if ( error ?. type === 'not-found' ) { showNoDeviceMessage ( error . missingMedia ); } else { showGenericDeviceError ( error ?. msg ); } });
available-devices-updated Fires when a device becomes available or is removed — for example when a headset is connected or disconnected. See enumerateDevices()
Always "available-devices-updated".
The ID of the call client instance that emitted this event.
An array of MediaDeviceInfo // Example event object { "action" : "available-devices-updated" , "callClientId" : "17225364729060.9442072768918943" , "availableDevices" : [ { "deviceId" : "abc123" , "groupId" : "" , "kind" : "videoinput" , "label" : "Front Camera" }, { "deviceId" : "def456" , "groupId" : "" , "kind" : "audioinput" , "label" : "Built-in Microphone" }, { "deviceId" : "ghi789" , "groupId" : "" , "kind" : "audiooutput" , "label" : "Built-in Speakers" } ] }
selected-devices-updated Fires when the participant selects a new input or output device. Unlike available-devices-updated
Always "selected-devices-updated".
The ID of the call client instance that emitted this event.
Contains camera, mic, and speaker keys with MediaDeviceInfo // Example event object { "action" : "selected-devices-updated" , "callClientId" : "17225364729060.9442072768918943" , "devices" : { "camera" : {}, "mic" : {}, "speaker" : { "deviceId" : "deviceId" , "kind" : "audiooutput" , "label" : "label" , "groupId" : "groupId" } } }
Fires every time the input settings object changes. Includes all current input settings, even those that did not change. See updateInputSettings()
Always "input-settings-updated".
The ID of the call client instance that emitted this event.
The full current input settings object, including video and audio keys with their settings and processor sub-objects.
// Example event object { "action" : "input-settings-updated" , "callClientId" : "17225364729060.9442072768918943" , "inputSettings" : { "video" : { "settings" : { "frameRate" : 15 }, "processor" : { "type" : "background-blur" , "config" : { "strength" : 0.2 } } }, "audio" : { "settings" : { "deviceId" : "default" , "echoCancellation" : false }, "processor" : { "type" : "noise-cancellation" } } } }
send-settings-updated Fires when the call’s send settings change. Includes the full current send settings object.
Always "send-settings-updated".
The ID of the call client instance that emitted this event.
// Example event object { "action" : "send-settings-updated" , "callClientId" : "17225364729060.9442072768918943" , "sendSettings" : { "video" : "default" } }
receive-settings-updated Fires when the call’s receive settings change. Includes the full current receive settings object.
Always "receive-settings-updated".
The ID of the call client instance that emitted this event.
// Example event object { "action" : "receive-settings-updated" , "callClientId" : "17225364729060.9442072768918943" , "receiveSettings" : { "base" : { "video" : { "layer" : 2 } } } }
See also 
