Class Call

Browser P2P mesh call over a signaling Room. Manages one PeerConnection per remote peer, wiring perfect negotiation, ICE, and track publishing so that adding a track fans it out to every peer.

It reacts to room membership: joining peers get a new connection, leaving peers are torn down, and a RoomEvent.Refreshed triggers a full Call.restart. All observable activity is surfaced as MediaEvents.

Remarks

Intended for small mesh calls where each participant connects directly to every other participant. For many-participant rooms, use the SFU (MediaService) instead.

Example

const stream = await getUserMedia({ audio: true, video: true })
const call = new Call(room, { stream, iceServers })

call.on(MediaEvent.RemoteStream, (peerId, remoteStream) => {
  attachToVideoElement(peerId, remoteStream)
})
call.on(MediaEvent.RemoteStreamRemoved, (peerId) => detach(peerId))

call.start()
// later
call.close()

Hierarchy (View Summary)

EventEmitter<CallEvents>
- Call

Constructors

constructor

new Call(room: Room, opts?: CallOptions): Call
Parameters
- room: Room
  The signaling room whose membership and signal messages drive the mesh.
- opts: CallOptions = {}
  Call configuration (initial stream, ICE servers, codec, simulcast, etc.). Defaults to {}.
Returns Call
Overrides EventEmitter.constructor
- Defined in media/src/Call.ts:75

Methods

addScreenTrack

addScreenTrack(track: MediaStreamTrack, stream: MediaStream): void
Publishes a screen-share track, applying the content hint and max bitrate from CallOptions.screenShare. Convenience over Call.addTrack.
Parameters
- track: MediaStreamTrack
  The screen-capture track.
- stream: MediaStream
  The stream the track belongs to.
Returns void
- Defined in media/src/Call.ts:186

addTrack

addTrack(
    track: MediaStreamTrack,
    stream: MediaStream,
    opts?: { contentHint?: string; maxBitrate?: number },
): void
Publishes a local track to every peer connection and registers it so it is also added to peers that join later. Emits MediaEvent.TrackPublished.
Parameters
- track: MediaStreamTrack
  The local media track to send.
- stream: MediaStream
  The stream the track belongs to.
- Optionalopts: { contentHint?: string; maxBitrate?: number }
  Optional per-track overrides.
  - OptionalcontentHint?: string
    Encoder content hint set on the track (e.g. "motion", "detail").
  - OptionalmaxBitrate?: number
    Maximum send bitrate in bits per second; falls back to CallOptions.maxBitrate.
Returns void
- Defined in media/src/Call.ts:144

close

close(): void
Permanently closes the call: stops active-speaker detection, clears local tracks, detaches room listeners, and closes every peer connection. Idempotent; a closed call cannot be restarted with Call.start.

Returns void
- Defined in media/src/Call.ts:320

createDataChannel

createDataChannel(
    peerId: string,
    label: string,
    opts?: RTCDataChannelInit,
): RTCDataChannel | undefined
Opens a data channel to a specific peer.
Parameters
- peerId: string
  The target peer's id.
- label: string
  Data channel label.
- Optionalopts: RTCDataChannelInit
  Optional data channel configuration.
Returns RTCDataChannel | undefined
The created data channel, or undefined if no connection to that peer exists.
- Defined in media/src/Call.ts:201

emit

emit<K extends keyof CallEvents>(event: K, ...args: CallEvents[K]): boolean
Synchronously invokes every listener registered for event, in registration order.
Type Parameters
- K extends keyof CallEvents
Parameters
- event: K
  The event name to emit.
- ...args: CallEvents[K]
  The argument tuple to pass to each listener, matching Events[event].
Returns boolean
true if at least one listener was invoked, false if there were none.

Remarks
The listener list is snapshotted before dispatch, so mutations made by handlers take effect only on subsequent emissions. Listeners are isolated: if one throws, the remaining listeners still run and the error is surfaced via console.error rather than swallowed silently (consistent with LocalMessageBus).
Inherited from EventEmitter.emit
- Defined in core/src/EventEmitter.ts:95

getStats

getStats(peerId?: string): Promise<Map<string, RTCStatsReport>>
Collects WebRTC statistics for one or all peer connections.
Parameters
- OptionalpeerId: string
  If given, returns stats for just that peer; otherwise for all connected peers.
Returns Promise<Map<string, RTCStatsReport>>
A map of peer id to its RTCStatsReport.
- Defined in media/src/Call.ts:215

isAudioMuted

isAudioMuted(): boolean
Returns boolean
Whether the local audio tracks are currently muted.
- Defined in media/src/Call.ts:285

isVideoMuted

isVideoMuted(): boolean
Returns boolean
Whether the local video tracks are currently muted.
- Defined in media/src/Call.ts:289

listenerCount

listenerCount<K extends keyof CallEvents>(event: K): number
Returns the number of listeners currently registered for event.
Type Parameters
- K extends keyof CallEvents
Parameters
- event: K
  The event name to count listeners for.
Returns number
The count of registered listeners (0 if none).
Inherited from EventEmitter.listenerCount
- Defined in core/src/EventEmitter.ts:128

muteAudio

muteAudio(): void
Disables all local audio tracks (mutes the microphone) without renegotiating.

Returns void
- Defined in media/src/Call.ts:269

muteVideo

muteVideo(): void
Disables all local video tracks (stops sending camera frames) without renegotiating.

Returns void
- Defined in media/src/Call.ts:277

off

off<K extends keyof CallEvents>(
event: K,
listener: (...args: CallEvents[K]) => void,
): this
Removes a previously registered listener for event.
Type Parameters
- K extends keyof CallEvents
Parameters
- event: K
  The event name the listener was registered for.
- listener: (...args: CallEvents[K]) => void
  The exact function reference passed to on or once.
Returns this
This emitter, for chaining.

Remarks
If the listener is not currently registered, this is a no-op. Only the first matching registration is removed.
Inherited from EventEmitter.off
- Defined in core/src/EventEmitter.ts:74

on

on<K extends keyof CallEvents>(
event: K,
listener: (...args: CallEvents[K]) => void,
): this
Registers a listener that is invoked every time event is emitted.
Type Parameters
- K extends keyof CallEvents
Parameters
- event: K
  The event name to listen for.
- listener: (...args: CallEvents[K]) => void
  Callback invoked with the event's argument tuple.
Returns this
This emitter, for chaining.
Inherited from EventEmitter.on
- Defined in core/src/EventEmitter.ts:43

once

once<K extends keyof CallEvents>(
event: K,
listener: (...args: CallEvents[K]) => void,
): this
Registers a listener that is invoked at most once: it is removed automatically before being called the first time event is emitted.
Type Parameters
- K extends keyof CallEvents
Parameters
- event: K
  The event name to listen for.
- listener: (...args: CallEvents[K]) => void
  Callback invoked with the event's argument tuple on the next emission.
Returns this
This emitter, for chaining.

Remarks
Remove a pending one-time listener by passing the same function reference to off.
Inherited from EventEmitter.once
- Defined in core/src/EventEmitter.ts:57

removeAllListeners

removeAllListeners(event?: keyof CallEvents): this
Removes listeners for a single event, or for all events.
Parameters
- Optionalevent: keyof CallEvents
  The event name to clear; if omitted, listeners for every event are removed.
Returns this
This emitter, for chaining.
Inherited from EventEmitter.removeAllListeners
- Defined in core/src/EventEmitter.ts:116

removeTrack

removeTrack(track: MediaStreamTrack): void
Unpublishes a track from every peer connection and removes it from the local registry.
Parameters
- track: MediaStreamTrack
  The track to remove.
Returns void
- Defined in media/src/Call.ts:260

replaceTrack

replaceTrack(
oldTrack: MediaStreamTrack,
newTrack: MediaStreamTrack,
): Promise<void>
Replaces a published track with a new one on every peer connection without renegotiation (e.g. switching cameras). Updates the local track registry.
Parameters
- oldTrack: MediaStreamTrack
  The currently published track.
- newTrack: MediaStreamTrack
  The track to send in its place.
Returns Promise<void>
- Defined in media/src/Call.ts:168

restart

restart(): void
Tears down all connections and room listeners, then starts fresh. Local published tracks are preserved and re-added to the new connections. Invoked automatically when the room signals RoomEvent.Refreshed.

Returns void
- Defined in media/src/Call.ts:298

start

start(): void
Starts the call: creates connections to all current peers and subscribes to room membership and signaling events. Idempotent, and a no-op once the call has been closed.

Returns void
- Defined in media/src/Call.ts:117

startActiveSpeakerDetection

startActiveSpeakerDetection(intervalMs?: number): void
Starts polling remote audio levels and emitting MediaEvent.ActiveSpeaker when the dominant speaker changes. Idempotent.
Parameters
- intervalMs: number = 1000
  Poll interval in milliseconds.
Returns void
Default Value
```
1000
```
- Defined in media/src/Call.ts:237

stopActiveSpeakerDetection

stopActiveSpeakerDetection(): void
Stops active-speaker detection and releases its resources. Idempotent.

Returns void
- Defined in media/src/Call.ts:249

unmuteAudio

unmuteAudio(): void
Re-enables all local audio tracks.

Returns void
- Defined in media/src/Call.ts:273

unmuteVideo

unmuteVideo(): void
Re-enables all local video tracks.

Returns void
- Defined in media/src/Call.ts:281

Class Call

Remarks

Example

Hierarchy (View Summary)

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns Call

Methods

addScreenTrack

Parameters

Returns void

addTrack

Parameters

OptionalcontentHint?: string

OptionalmaxBitrate?: number

Returns void

close

Returns void

createDataChannel

Parameters

Returns RTCDataChannel | undefined

emit

Type Parameters

Parameters

Returns boolean

Remarks

getStats

Parameters

Returns Promise<Map<string, RTCStatsReport>>

isAudioMuted

Returns boolean

isVideoMuted

Returns boolean

listenerCount

Type Parameters

Parameters

Returns number

muteAudio

Returns void

muteVideo

Returns void

off

Type Parameters

Parameters

Returns this

Remarks

on

Type Parameters

Parameters

Returns this

once

Type Parameters

Parameters

Returns this

Remarks

removeAllListeners

Parameters

Returns this

removeTrack

Parameters

Returns void

replaceTrack

Parameters

Returns Promise<void>

restart

Returns void

start

Returns void

startActiveSpeakerDetection

Parameters

Returns void

Default Value

stopActiveSpeakerDetection

Returns void

unmuteAudio

Returns void

`Optional`contentHint?: string

`Optional`maxBitrate?: number