Settings & device events

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.

For more on handling device errors, see the device permissions guide.

string

Always "camera-error".

string

The ID of the call client instance that emitted this event.

object

Always contains type and msg. Some types include additional fields.

Hide error.type values

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"] }

DailyCamPermissionsError

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"] }

DailyCamInUseError

Camera and/or microphone in use by another application. Windows only.

{ "type": "cam-in-use", "msg": "Camera in use by another application." }

DailyCamConstraintsError

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"] }

DailyCamTypeError

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." }

DailyCamUnknownError

Uncategorized error. The original browser error message is in msg.

{ "type": "unknown", "msg": "Unknown device error (NotReadableError)" }

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() for details on the device properties returned.

string

Always "available-devices-updated".

string

The ID of the call client instance that emitted this event.

MediaDeviceInfo[]

An array of MediaDeviceInfo objects representing all devices currently available to the browser.

// 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, which fires whenever the system device list changes, this event only fires when the participant has actively chosen a different device.

string

Always "selected-devices-updated".

string

The ID of the call client instance that emitted this event.

object

Contains camera, mic, and speaker keys with MediaDeviceInfo-shaped objects for the newly selected devices.

// Example event object
{
  "action": "selected-devices-updated",
  "callClientId": "17225364729060.9442072768918943",
  "devices": {
    "camera": {},
    "mic": {},
    "speaker": { "deviceId": "deviceId", "kind": "audiooutput", "label": "label", "groupId": "groupId" }
  }
}

input-settings-updated

Fires every time the input settings object changes. Includes all current input settings, even those that did not change. See updateInputSettings() for details on the settings shape.

string

Always "input-settings-updated".

string

The ID of the call client instance that emitted this event.

object

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.

string

Always "send-settings-updated".

string

The ID of the call client instance that emitted this event.

DailySendSettings

The full current send settings object. See updateSendSettings() for the shape.

// 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.

string

Always "receive-settings-updated".

string

The ID of the call client instance that emitted this event.

DailyReceiveSettings

The full current receive settings object. See updateReceiveSettings() for the shape.

// Example event object
{
  "action": "receive-settings-updated",
  "callClientId": "17225364729060.9442072768918943",
  "receiveSettings": {
    "base": { "video": { "layer": 2 } }
  }
}

Daily Call Client

Types

Static Methods

Instance Methods

Events

Settings & device events

started-camera

camera-error

available-devices-updated

selected-devices-updated

input-settings-updated

send-settings-updated

receive-settings-updated

See also

Methods

Guides

​started-camera

​camera-error

​available-devices-updated

​selected-devices-updated

​input-settings-updated

​send-settings-updated

​receive-settings-updated

​See also

Methods

Guides

started-camera

camera-error

available-devices-updated

selected-devices-updated

input-settings-updated

send-settings-updated

receive-settings-updated

See also