updateReceiveSettings()

updateReceiveSettings(receiveSettings) Prebuilt Custom Updates how you receive video tracks from remote participants — specifically, the maximum simulcast layer to decode for each participant’s video and screenVideo tracks. Higher layers correspond to higher quality. Settings can be applied per-participant, to all current participants at once via '*', or to base — a set of defaults inherited by all participants who don’t have explicit settings applied.

Simulcast layer settings only apply in SFU mode. Desktop clients support 3 layers (0–2); mobile clients support 2 layers (0–1). Requesting a higher layer than is available is allowed — you’ll receive the highest available.

initialReceiveBitrate is a join-time-only setting and can’t be updated with this method. See the receiveSettings call property for details.

Parameters

DailyReceiveSettingsUpdates

required

An object whose keys identify which participants to update, and whose values are the settings to apply.

Hide Key options

DailySingleParticipantReceiveSettingsUpdates | 'inherit'

Settings for a specific participant. Pass 'inherit' to reset them to the base defaults.

DailySingleParticipantReceiveSettingsUpdates

Default settings inherited by all participants who don’t have explicit settings. Applies to current and future participants. Set this at join time via the receiveSettings call property to configure defaults before anyone joins.

DailySingleParticipantReceiveSettingsUpdates

Shorthand to apply the same settings to all participants currently connected to you. Unlike base, '*' has no effect before joining and does not apply to future participants.

Each value (other than 'inherit') is a DailySingleParticipantReceiveSettingsUpdates object:

Hide DailySingleParticipantReceiveSettingsUpdates fields

{ layer?: number | 'inherit' } | 'inherit'

Receive settings for the participant’s camera track. layer selects the simulcast layer (default: 2). Pass 'inherit' to reset to the base value.

{ layer?: number | 'inherit' } | 'inherit'

Receive settings for the participant’s screen share track. Screen video has one layer by default; additional layers require configuration via updateSendSettings().

Return value

Returns Promise<DailyReceiveSettings> that resolves with the full updated receive settings for all participants.

Examples

// Set a low-quality default for all participants at join time
call.join({
  url,
  receiveSettings: {
    base: { video: { layer: 0 } },
  },
});

// After joining: lower quality for everyone, promote the active speaker
await call.updateReceiveSettings({
  '*': { video: { layer: 0 } },
  [activeSpeakerSessionId]: { video: { layer: 2 } },
});

// Reset a participant to inherit from base
await call.updateReceiveSettings({
  [sessionId]: 'inherit',
});

// Reset a single track for a participant while leaving others unchanged
await call.updateReceiveSettings({
  [sessionId]: { video: 'inherit' },
});

Types

DailyCallOptions: receiveSettings

Methods

Events

receive-settings-updated

Guides

Receive-side video quality

Daily Call Client

Types

Factory Methods

Static Methods

Instance Methods

Events

updateReceiveSettings()

Parameters

Return value

Examples

See also

Types

Methods

Events

Guides

​Parameters

​Return value

​Examples

​See also

Types

Methods

Events

Guides

Parameters

Return value

Examples

See also