Skip to main content

WebRTC JS Call Options

ICallOptions ICallOptions

Table of contents

Properties

Properties

audio

Optional audio: boolean

Overrides client's default audio constraints. Defaults to true


callerName

Optional callerName: string

Name to use as the caller ID name when dialing out to a destination.


callerNumber

Optional callerNumber: string

Number to use as the caller ID when dialing out to a destination. A valid phone number is required for dials out to PSTN numbers.


camId

Optional camId: string

deviceId to use as webcam. Overrides the client's default one.


clientState

Optional clientState: string

Telnyx's Call Control client_state. Can be used with Connections with Advanced -> Events enabled. clientState string should be base64 encoded.


customHeaders

Optional customHeaders: { name: string ; value: string }[]

Add custom headers to the INVITE and ANSWER request.


debug

Optional debug: boolean

Enable debug mode for this call.


debugOutput

Optional debugOutput: "file" | "socket"

Output debug logs to a file.


destinationNumber

destinationNumber: string

Phone number or SIP URI to dial.


forceRelayCandidate

Optional forceRelayCandidate: boolean

Force the use of a relay ICE candidate.


iceServers

Optional iceServers: RTCIceServer[]

Overrides client's default iceServers.


id

Optional id: string

Custom ID to identify the call. This will be used as the callID in place of the UUID generated by the client.


localElement

Optional localElement: string | HTMLMediaElement

Overrides client's default localElement.


localStream

Optional localStream: MediaStream

If set, the call will use this stream instead of retrieving a new one.


mediaSettings

Optional mediaSettings: Object

Configures media (audio/video) in a call.

Type declaration

NameType
sdpASBandwidthKbps?number
useSdpASBandwidthKbps?boolean

micId

Optional micId: string

deviceId to use as microphone. Overrides the client's default one.


onNotification

Optional onNotification: Function

Overrides client's default telnyx.notification handler for this call.


preferred_codecs

Optional preferred_codecs: RTCRtpCodecCapability[]

Preferred codecs for the call.


prefetchIceCandidates

Optional prefetchIceCandidates: boolean

Enable or disable ICE Candidate Prefetching.


remoteElement

Optional remoteElement: string | HTMLMediaElement

Overrides client's default remoteElement.


remoteStream

Optional remoteStream: MediaStream

If set, the call will use this stream instead of retrieving a new one.


speakerId

Optional speakerId: string

deviceId to use as speaker. Overrides the client's default one.


telnyxCallControlId

Optional telnyxCallControlId: string

Telnyx Call Control ID, if using Call Control services.


telnyxLegId

Optional telnyxLegId: string

Telnyx call leg ID, if using Call Control services.


telnyxSessionId

Optional telnyxSessionId: string

Telnyx call session ID, if using Call Control services.


useStereo

Optional useStereo: boolean

Uses stereo audio instead of mono.


video

Optional video: boolean

Overrides client's default video constraints. Defaults to false