Skip to main content

RecordingConfig

Configure session recording (audio, video, transcript, and upload). See RecordingConfigOptions.

Constructor

enabled
boolean
Master switch for session recording. Defaults to false.
autoStart
boolean
Start recording automatically when the session begins. Defaults to true.
format
'wav' | 'ogg_opus' | 'mp3' | 'flac'
Output audio format. Defaults to 'ogg_opus'.
channelMode
'mixed' | 'dual_channel'
'mixed' for a single combined track, 'dual_channel' to separate participants. Defaults to 'dual_channel'.
sampleRate
number
Output sample rate in Hz. Defaults to 0 (use source rate).
bitrateKbps
number
Output bitrate in kbps for compressed formats. Defaults to 0 (codec default).
storage
S3StorageConfig | null
Where to upload the recording. Defaults to null (default storage). See S3StorageConfig.
transcript
RecordingTranscriptConfig | null
Transcript settings. Defaults to null (no transcript). See RecordingTranscriptConfig.
maxDurationSeconds
number
Maximum recording length in seconds. Defaults to 0 (no limit).
maxFileSizeMb
number
Maximum recording file size in MB. Defaults to 0 (no limit).
recordingBeep
boolean
Play a beep to indicate recording is active. Defaults to false.
redactDtmf
boolean
Mute DTMF tones in the recording. Defaults to false.
customMetadata
Record<string, string>
Custom metadata stored with the recording.
recordingName
string
Human-readable name for the recording. Defaults to ''.
recordingGroup
string
Group/label used to bucket related recordings. Defaults to ''.
applyDenoise
boolean
Apply denoising to recorded audio. Defaults to false.
normalizeAudio
boolean
Normalize recorded audio loudness. Defaults to false.
trimSilence
boolean
Trim leading/trailing silence. Defaults to false.
recordVideo
boolean
Record participant video. Defaults to false.
recordScreenShare
boolean
Record screen-share video. Defaults to false.
recordScreenAudio
boolean
Record screen-share audio. Defaults to false.

S3StorageConfig

Configure an S3 (or S3-compatible) destination for recording uploads. See S3StorageConfigOptions.

Constructor

bucket
string
Target S3 bucket name.
region
string
AWS region of the bucket.
prefix
string
Key prefix prepended to uploaded objects.
accessKeyId
string
AWS access key id. Leave empty to use the default configured credentials.
secretAccessKey
string
AWS secret access key.
sessionToken
string
Temporary session token for STS credentials.
endpointUrl
string
Custom S3-compatible endpoint URL (for non-AWS providers).
storageClass
string
S3 storage class (e.g. STANDARD, STANDARD_IA).
serverSideEncryption
string
Server-side encryption mode (e.g. AES256, aws:kms).
kmsKeyId
string
KMS key id used when serverSideEncryption is aws:kms.
acl
string
Canned ACL applied to uploaded objects.
multipartUpload
boolean
Whether to use multipart upload for large objects. Defaults to true.
multipartPartSizeMb
number
Part size in MB for multipart uploads. Defaults to 8.
uploadTimeoutSeconds
number
Per-upload timeout in seconds. Defaults to 0 (no limit).
maxRetryAttempts
number
Number of upload retry attempts. Defaults to 3.
tags
Record<string, string>
Object tags to attach to uploads.
userMetadata
Record<string, string>
Custom x-amz-meta-* metadata to attach to uploads.
contentTypeOverride
string
Overrides the auto-detected Content-Type.

RecordingTranscriptConfig

Configure transcript generation for a recording. See RecordingTranscriptConfigOptions.

Constructor

enabled
boolean
Whether to produce a transcript alongside the recording. Defaults to false.
format
'json' | 'srt' | 'vtt'
Transcript file format. Defaults to 'json'.
includeWordTimestamps
boolean
Include per-word timestamps. Defaults to false.
includeConfidence
boolean
Include per-segment confidence scores. Defaults to false.
speakerLabels
boolean
Label each segment with its speaker. Defaults to true.
language
string
Transcript language hint (BCP-47 code). Defaults to '' (auto-detect).

RecordingOptions

Configure which media a room recording captures. See RecordingOptionsInit.

Constructor

video
boolean
Record participant video. Defaults to false.
screenShare
boolean
Record screen-share. Defaults to false.

RecordingFormat

Container/codec for a call recording.

RecordingChannelMode

Channel layout for a call recording.

RecordingTranscriptFormat

Output format for a recording’s transcript.

RecordingState

Current state of a recording, reported via recording status events.

BackgroundAudioHandlerConfig

Create a BackgroundAudioHandlerConfig.

Constructor

file
string
Path to the audio file to play. Default: ''.
volume
number
Playback volume multiplier, where 1.0 is the original level. Default: 1.0.
looping
boolean
Whether to loop the file continuously. Default: false.
enabled
boolean
Whether background audio is active. Default: true.
mode
BackgroundAudioMode
Playback vs. mixing behavior. Default: 'mixing'.
chunkSize
number
Number of audio samples per processing chunk. Default: 320.