Interface TrackPublishDefaults

which audio preset should be used for publishing (audio) tracks defaults to [[AudioPresets.music]]

Multi-codec Simulcast VP9 and AV1 are not supported by all browser clients. When backupCodec is set, when an incompatible client attempts to subscribe to the track, LiveKit will automatically publish a secondary track encoded with the backup codec.

You could customize specific encoding parameters of the backup track by explicitly setting codec and encoding fields.

Defaults to true

degradation preference

dtx (Discontinuous Transmission of audio), enabled by default for mono tracks.

publish track in stereo mode (or set to false to disable). defaults determined by capture channel count.

red (Redundant Audio Data), enabled by default for mono tracks.

scalability mode for svc codecs, defaults to 'L3T3_KEY'. for svc codecs, simulcast is disabled.

encoding parameters for screen share track

custom video simulcast layers for screen tracks Note: the layers need to be ordered from lowest to highest quality

use simulcast, defaults to true. When using simulcast, LiveKit will publish up to three versions of the stream at various resolutions.

For local tracks, stop the underlying MediaStreamTrack when the track is muted (or paused) on some platforms, this option is necessary to disable the microphone recording indicator. Note: when this is enabled, and BT devices are connected, they will transition between profiles (e.g. HFP to A2DP) and there will be an audible difference in playback.

defaults to false

codec, defaults to vp8; for svc codecs, auto enable vp8 as backup. (TBD)

encoding parameters for camera track

Up to two additional simulcast layers to publish in addition to the original Track. When left blank, it defaults to h180, h360. If a SVC codec is used (VP9 or AV1), this field has no effect.

To publish three total layers, you would specify: { videoEncoding: {...}, // encoding of the primary layer videoSimulcastLayers: [ VideoPresets.h540, VideoPresets.h216, ], }