Overview
TransportParams is the base configuration class for all Pipecat transports. It controls audio input/output settings and video settings. Every transport’s params class (DailyParams, LiveKitParams, SingleClientWebsocketServerParams, etc.) inherits from TransportParams.
You typically pass these via the transport’s params argument:
Audio Output
Output audio sample rate in Hz. When
None, uses
PipelineParams.audio_out_sample_rate (24000 by default).Number of 10ms chunks to buffer before sending output audio. Higher values
increase latency but reduce overhead.
Audio filter to apply to output audio of the default destination, before the
mixer. Audio the transport generates itself (mixer audio, end silence, DTMF
tones) is not filtered.
Volume of the output audio, as a multiplier on its samples, applied after the
filter and before the mixer. A
VolumeFrame changes it while the transport
runs, and a VolumeGainFrame adjusts it for some audio.Audio mixer instance for combining audio streams, or a mapping of destination
names to mixer instances. In a mapping, the
None key sets the mixer for the
default destination.List of audio output destination identifiers for routing audio to specific
participants or endpoints.
Insert silence frames when the audio output queue is empty. When
False, the
transport waits for audio data instead of inserting silence, which is useful
for scenarios that require uninterrupted audio playback without artificial
gaps. Only DailyTransport and SmallWebRTCTransport use it.Maximum time in seconds a single write to the transport may take before the
peer is considered gone. A client that stops reading leaves the write waiting
with nothing to fail, so exceeding this timeout marks the transport as
unusable.
Audio Input
Input audio sample rate in Hz. When
None, uses
PipelineParams.audio_in_sample_rate (16000 by default).Start audio input streaming immediately when the transport starts. When
False, audio input begins when an InputTransportStartAudioStreamingFrame
reaches the input transport; the RTVI processor pushes one when the client is
ready. Only DailyTransport uses it.Pass input audio frames downstream through the pipeline. When
False, input
audio is not pushed downstream, so processors after the input transport, such
as STT, receive none.Video Output
Enable real-time video output. When
True, each OutputImageRawFrame is
queued and sent at video_out_framerate. When False, the latest image is
redrawn repeatedly at video_out_framerate.Deprecated since 1.1.0, removed in 2.0.0. Use provider-specific settings
instead (e.g.,
DailyParams.camera_out_send_settings for Daily).Video Input
Video sources to capture from each user as they connect, keyed by source
(
"camera", "screenVideo", or a transport-specific custom source).
DailyTransport captures them from each participant as they join,
SmallWebRTCTransport when the peer connects, and LiveKitTransport when the
participant’s track is subscribed. Sources not listed are captured only when
the application asks, for example with the transport’s
capture_participant_video(). Requires video_in_enabled=True. Other
transports log a warning and ignore it.VideoInSourceParams
Controls how a transport captures one video source from the user.Frames per second to pass on from this source. Must be at least 1. Cannot be
set together with
on_request_only=True.Pass on frames only to answer a
UserImageRequestFrame, rather than
continuously at framerate.Capturing video on demand
BaseTransport.capture_participant_video(participant_id, framerate=30, video_source="camera", *, on_request_only=False) captures a user’s video source on demand and takes precedence over video_in_sources for that source. It is implemented by DailyTransport, SmallWebRTCTransport and LiveKitTransport. Other transports, including TavusTransport and LemonSliceTransport, log a warning. A framerate of None passes on every frame, and on_request_only=True passes on only the frames that answer image requests. Passing framerate=0 is deprecated since 1.13.0; use on_request_only=True.
BaseTransport.get_client_id(client) returns the participant_id for the client passed to on_client_connected: the participant id on Daily, the participant identity on LiveKit, the peer connection id on SmallWebRTC and the stream id on Vonage. Other transports log a warning and return an empty string.
SmallWebRTCTransport, calling capture_participant_video() without a participant_id is deprecated since 1.13.0.
Transport Subclasses
Each transport extendsTransportParams with provider-specific fields: