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

Prebuilt Custom 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

Prebuilt Custom 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

Prebuilt Custom 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

Prebuilt Custom 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

Prebuilt Custom 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

Prebuilt Custom Fires when video or custom track send settings change. This fires once upon join() and again each time updateSendSettings() is called.

string

Always "send-settings-updated".

string

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

object

The full current send settings object. Contains per-track keys (video, screenVideo, customVideoDefaults) each with maxQuality and encodings sub-objects.

// Example event object
{
  "action": "send-settings-updated",
  "callClientId": "17225364729060.9442072768918943",
  "sendSettings": {
    "video": {
      "maxQuality": "high",
      "encodings": {
        "low": { "maxBitrate": 90000, "scaleResolutionDownBy": 4, "maxFramerate": 15 },
        "medium": { "maxBitrate": 200000, "scaleResolutionDownBy": 2, "maxFramerate": 15 },
        "high": { "maxBitrate": 680000, "scaleResolutionDownBy": 1, "maxFramerate": 30 }
      }
    },
    "screenVideo": {
      "maxQuality": "low",
      "encodings": {
        "low": { "maxBitrate": 2000000, "scaleResolutionDownBy": 1, "maxFramerate": 30 }
      }
    }
  }
}

receive-settings-updated

Prebuilt Custom Fires when media receive settings change. This fires once upon join() with the initial base settings, and again each time updateReceiveSettings() is called.

string

Always "receive-settings-updated".

string

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

DailyReceiveSettings

A map of participant ID or 'base' to receive settings. The 'base' key holds the default settings applied to all participants. Additional keys are participant session_id values with per-participant overrides.

// Example event object
{
  "action": "receive-settings-updated",
  "callClientId": "17225364729060.9442072768918943",
  "receiveSettings": {
    "base": { "video": { "layer": 2 }, "screenVideo": { "layer": 0 } },
    "f2190c86-169a-464f-c0a4-ee1d5c00af58": { "video": { "layer": 0 } }
  }
}

Daily Call Client

Types

Factory Methods

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