For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Log inSign up
Support
GuidesReferenceClick-to-Call
GuidesReferenceClick-to-Call
  • Core
    • Overview
  • Entities
    • SignalWire
    • Address
    • Participant
    • ClientPreferences
    • SelfCapabilities
    • SelfParticipant
    • User
    • WebRTCCall
      • AddressHistory<TAddress>
      • AudioConstraintsEvent
      • AuthenticateContext
      • Call
      • CallAddress
      • CallCapabilitiesState
      • CallDiagnosticSummary
      • CallError
      • CallNetworkIssue
      • CallNetworkMetrics
      • CallOptions
      • CallParticipant
      • CallSelfParticipant
      • CallState
      • ConstraintFallbackEvent
      • CredentialNoRefreshHandlerWarning
      • CredentialProvider
      • CredentialRefreshFallbackWarning
      • DebugOptions
      • DeviceController
      • DeviceRecoveryEvent
      • DiagnosticEvent
      • DialOptions
      • Directory
      • JSONRPCErrorResponse
      • JSONRPCRequest<TParams>
      • JSONRPCSuccessResponse<TResult>
      • LayoutLayer
      • MediaDirections
      • MediaOptions
      • MediaParamsEvent
      • MemberCapabilities
      • NodeSocketAdapter
      • OnOffCapability
      • PendingRPCOptions
      • PermissionResult
      • PlatformCapabilities
      • PreflightOptions
      • PreflightResult
      • RecoveryEvent
      • SATClaims
      • SDKCredential
      • SDKLogger
      • SelectDeviceOptions
      • SessionDiagnostics
      • SessionState
      • SignalWireOptions
      • Storage
      • StoredDevicePreference
      • TextMessage<TAddress>
      • TransferOptions
      • WebRTCApiProvider
      • WebRTCMediaDevices
  • Web Components
    • Overview
    • sw-audio-level
    • sw-call-controls
    • sw-call-dialpad
    • sw-call-media
    • sw-call-provider
    • sw-call-status
    • sw-call-widget
    • sw-click-to-call
    • sw-device-selector
    • sw-directory
    • sw-local-camera
    • sw-participant-controls
    • sw-participants
    • sw-self-media
    • sw-ui-alert
    • sw-ui-background
    • sw-ui-call-layout
    • sw-ui-content-drawer
    • sw-ui-control-bar
    • sw-ui-dialpad
    • sw-ui-dropup
    • sw-ui-icon
    • sw-ui-modal
    • sw-ui-responsive-container
    • sw-ui-split-button
    • sw-ui-transcript-view
LogoLogoSignalWire Docs
Log inSign up
Support
On this page
  • Extends
  • Properties
  • Methods
  • answer()
  • execute()
  • executeMethod()
  • hangup()
  • reject()
  • requestIceRestart()
  • requestKeyframe()
  • sendDigits()
  • setLayout()
  • setMeta()
  • startRecording()
  • startStreaming()
  • subscribe()
  • toggleHold()
  • toggleIncomingAudio()
  • toggleIncomingVideo()
  • toggleLock()
  • transfer()
  • updateMeta()
EntitiesInterfaces

Call

|View as Markdown|Open in Claude|
Was this page helpful?
Edit this page
Previous

CallAddress

Next
Built with

Public interface for an active WebRTC call.

Provides access to media streams, participants, layout, signaling events, and control actions (hangup, mute, transfer, etc.).

Extends

  • CallState

Properties

address
CallAddress

Address associated with the remote party of the call. See CallAddress.

address$
Observable<CallAddress | undefined>

Observable of the address associated with this call. See CallAddress.

bandwidthConstrained$
Observable<boolean>

Observable that emits true while the call is bandwidth-constrained.

capabilities
Capability[]

Set of capabilities currently granted to the local participant on this call. See Capability.

capabilities$
Observable<Capability[]>

Observable of the local participant’s current capability set on this call. See Capability.

direction
CallDirection

Whether this call is inbound or outbound. See CallDirection.

errors$
Observable<CallError>

Observable stream of errors raised on this call. See CallError.

from
string

URI of the calling party.

fromName
string

Display name of the calling party.

isNetworkHealthy
boolean

Whether the connection currently meets quality thresholds.

isNetworkHealthy$
Observable<boolean>

Observable of the call’s current network-health state.

layout
string

Name of the currently active video layout.

layout$
Observable<string>

Observable of the currently active layout name.

layoutLayers
LayoutLayer[]

Position and state of each layer in the active layout. See LayoutLayer.

layoutLayers$
Observable<LayoutLayer[]>

Observable of the active layout’s layer positions. See LayoutLayer.

layouts
string[]

List of layout names available on this call.

layouts$
Observable<string[]>

Observable of the list of available layout names.

localStream
MediaStream | null

Sync getter — returns null before the stream is created. See MediaStream.

localStream$
Observable<MediaStream>

Observable that emits only non-null MediaStreams (waits until the stream exists). See MediaStream.

mediaDirections
MediaDirections

Send/receive direction for each media track. See MediaDirections.

mediaDirections$
Observable<MediaDirections>

Observable of the per-track media direction state. See MediaDirections.

mediaParamsUpdated$
Observable<MediaParamsEvent>

Observable that emits when media parameters are renegotiated. See MediaParamsEvent.

networkIssues
CallNetworkIssue[]

Recent network issues detected during the call. See CallNetworkIssue.

networkIssues$
Observable<CallNetworkIssue[]>

Observable stream of detected network issues. See CallNetworkIssue.

networkMetrics
CallNetworkMetrics[]

Recent network-metric samples for the call. See CallNetworkMetrics.

networkMetrics$
Observable<CallNetworkMetrics[]>

Observable of periodic network-metric samples. See CallNetworkMetrics.

qualityLevel$
Observable<QualityLevel>

Observable of the categorical call-quality level. See QualityLevel.

qualityScore$
Observable<number>

Observable of the numeric call-quality score (0–5).

recoveryEvent$
Observable<RecoveryEvent>

Observable stream of call-recovery events. See RecoveryEvent.

recoveryState$
Observable<RecoveryState>

Observable of the current recovery state. See RecoveryState.

remoteStream
MediaStream | null

Remote MediaStream for the call, or null if not yet available. See MediaStream.

remoteStream$
Observable<MediaStream>

Observable that emits only non-null MediaStreams (waits until the stream exists). See MediaStream.

rtcPeerConnection
RTCPeerConnection | undefined

Underlying RTCPeerConnection, or undefined if not yet established.

self
CallSelfParticipant | null

Local participant on the call, or null before join. See CallSelfParticipant.

self$
Observable<CallSelfParticipant | null>

Observable of the local participant, or null before join. See CallSelfParticipant.

signalingEvent$
Observable<Record<string, unknown>>

Observable stream of raw signaling events.

to
string

URI of the called party.

toName
string

Display name of the called party.

userVariables
Record<string, unknown>

Map of arbitrary user-defined variables associated with the call.

userVariables$
Observable<Record<string, unknown>>

Observable of the call’s user-variables bag.

Inherited from CallState
id
stringRequired

Unique identifier for this call.

locked
booleanRequired

Whether the call is locked to new participants.

locked$
Observable<boolean>Required

Observable of the call’s locked state.

meta
Record<string, unknown>Required

Arbitrary metadata bag associated with the call or member.

meta$
Observable<Record<string, unknown>>Required

Observable of the call-level metadata bag.

participants
CallParticipant[]Required

Current set of participants in the call. See CallParticipant.

participants$
Observable<CallParticipant[]>Required

Observable of the current participant list. See CallParticipant.

raiseHandPriority
booleanRequired

Whether raise-hand priority mode is active.

raiseHandPriority$
Observable<boolean>Required

Observable of the raise-hand priority mode state.

recording
booleanRequired

Whether a server-side recording is currently in progress.

recording$
Observable<boolean>Required

Observable of the current recording state.

status
CallStatusRequired

Lifecycle status of the call. See CallStatus.

status$
Observable<CallStatus>Required

Observable of the call’s lifecycle status. See CallStatus.

streaming
booleanRequired

Whether a server-side stream is currently active.

streaming$
Observable<boolean>Required

Observable of the current streaming state.

Methods

answer()

1answer(options?): void

Parameters

options
MediaOptions

Per-call options for this operation (media constraints, RPC timeouts, or transfer target depending on context). See MediaOptions.

Returns

void


execute()

1execute<T>(request, options?): Promise<T>

Type Parameters

Type ParameterDefault type
T extends JSONRPCResponseJSONRPCResponse

Parameters

request
JSONRPCRequestRequired

Outgoing JSON-RPC request to send. See JSONRPCRequest.

options
PendingRPCOptions

Per-call options for this operation (media constraints, RPC timeouts, or transfer target depending on context). See PendingRPCOptions.

Returns

Promise<T>


executeMethod()

1executeMethod<T>(target, method, args): Promise<T>

Type Parameters

Type ParameterDefault type
T extends JSONRPCResponseJSONRPCResponse

Parameters

target
stringRequired

Target identifier (member ID or destination URI) for the operation.

method
stringRequired

RPC method name to execute on the server.

args
Record<string, unknown>Required

Method-specific arguments to pass with the RPC.

Returns

Promise<T>


hangup()

1hangup(): Promise<void>

Returns

Promise<void>


reject()

1reject(): void

Returns

void


requestIceRestart()

1requestIceRestart(): Promise<void>

Returns

Promise<void>


requestKeyframe()

1requestKeyframe(): void

Returns

void


sendDigits()

1sendDigits(digits): Promise<void>

Parameters

digits
stringRequired

DTMF digit string to send.

Returns

Promise<void>


setLayout()

1setLayout(layout, positions): Promise<void>

Parameters

layout
stringRequired

Name of the currently active video layout.

positions
Record<string, VideoPosition>Required

Map of member IDs to layout positions. See VideoPosition.

Returns

Promise<void>


setMeta()

1setMeta(meta): Promise<void>

Parameters

meta
Record<string, unknown>Required

Arbitrary metadata bag associated with the call or member.

Returns

Promise<void>

Inherited from

CallState.setMeta


startRecording()

1startRecording(): Promise<void>

Returns

Promise<void>


startStreaming()

1startStreaming(): Promise<void>

Returns

Promise<void>


subscribe()

1subscribe(eventType): Observable<Record<string, unknown>>

Parameters

eventType
stringRequired

Name of the event to subscribe to.

Returns

Observable<Record<string, unknown>>


toggleHold()

1toggleHold(): Promise<void>

Returns

Promise<void>


toggleIncomingAudio()

1toggleIncomingAudio(): Promise<void>

Returns

Promise<void>


toggleIncomingVideo()

1toggleIncomingVideo(): Promise<void>

Returns

Promise<void>


toggleLock()

1toggleLock(): Promise<void>

Returns

Promise<void>


transfer()

1transfer(options): Promise<void>

Parameters

options
TransferOptionsRequired

Per-call options for this operation (media constraints, RPC timeouts, or transfer target depending on context). See TransferOptions.

Returns

Promise<void>


updateMeta()

1updateMeta(meta): Promise<void>

Parameters

meta
Record<string, unknown>Required

Arbitrary metadata bag associated with the call or member.

Returns

Promise<void>

Inherited from

CallState.updateMeta