Class HTTPConnector

Use HTTPConnector to negotiate a new RTCPeerConnection connection with the server using WHIP (WebRTC HTTP Ingest Protocol) or WHEP (WebRTC HTTP Egress Protocol).

Example

// Listener channel (no initial 'stream' parameter), listen to a stream without sending data
const connection = new HTTPConnector({endPoint, streamName});
// we get the media stream from server
connection.onOpen = stream => videoElement.srcObject = stream;

// Streamer channel (with initial 'stream' parameter), sends and receives media streams
const connection = new HTTPConnector({endPoint, streamName}, {stream: await navigator.mediaDevices.getUserMedia()});
// the media stream here is our local camera as passed in the above constructor
connection.onOpen = stream => {}

Hierarchy

SIPConnector
- HTTPConnector

Index

Constructors

constructor

new HTTPConnector(connectParams, stream?): HTTPConnector
Start the HTTPConnector.

By default, a listener channel is negotiated. To create a streamer channel, give a media stream parameter
Parameters
- connectParams: Params
- Optional stream: MediaStream
Returns HTTPConnector
Overrides SIPConnector.constructor
- Defined in src/connectors/HTTPConnector.ts:35

Properties

`Private` _fetch

_fetch: AbortController

`Private` _url

_url: URL

log

log: ILog

Start a log

Param

Returns

a Log object with the levels of log to call

Accessors

closed

get closed(): boolean
True when connector is closed, in other words when onClose event is fired

Returns boolean
Inherited from SIPConnector.closed
- Defined in src/connectors/SIPConnector.ts:91

codecs

get codecs(): Set<string>
Indicate codecs supported, should be set before than onOpen happen

Returns Set<string>
Inherited from SIPConnector.codecs
- Defined in src/connectors/SIPConnector.ts:112

opened

get opened(): boolean
True when connector is opened, in other words when onOpen event is fired

Returns boolean
Inherited from SIPConnector.opened
- Defined in src/connectors/SIPConnector.ts:84

stream

get stream(): undefined | MediaStream
Media Stream description delivred from the server if we are player, or build from the local camera if we are the streamer.

Returns undefined | MediaStream
Inherited from SIPConnector.stream
- Defined in src/connectors/SIPConnector.ts:98

streamName

get streamName(): string
Stream name, for example as+bc3f535f-37f3-458b-8171-b4c5e77a6137

Returns string
Inherited from SIPConnector.streamName
- Defined in src/connectors/SIPConnector.ts:105

Methods

`Protected` _open

_open(iceServer?): void
Main function which creates the RTCPeerConnection, creates the offer, calls the _sip method, then set the answer and calls onOpen
Parameters
- Optional iceServer: RTCIceServer
Returns void
Inherited from SIPConnector._open
- Defined in src/connectors/SIPConnector.ts:241

`Protected` _sip

_sip(offer): Promise<string>
Operates Session Initiation Protocol, this method implement the logic to send the SDP offer to the server and get the SDP answer in response.
Parameters
- offer: string
  SIP Offer
Returns Promise<string>
a Promise with SIP Answer as result
Overrides SIPConnector._sip
- Defined in src/connectors/HTTPConnector.ts:57

close

close(error?): void
Close the connector
Parameters
- Optional error: ConnectorError
  the error reason if is not a proper close
Returns void
Overrides SIPConnector.close
- Defined in src/connectors/HTTPConnector.ts:49

connectionInfos

connectionInfos(cacheDuration?): Promise<ConnectionInfos>
Returns connection info, such as round trip time, requests sent and received, bytes sent and received, and bitrates NOTE: This call is resource-intensive for the CPU.
Parameters
- cacheDuration: number = 1000
Returns Promise<ConnectionInfos>
A promise that resolves to an RTCStatsReport object
Inherited from SIPConnector.connectionInfos
- Defined in src/connectors/SIPConnector.ts:147

off

off(name, event): boolean
Event unsubscription
Parameters
- name: "open" | "close" | "Close" | "Open"
  Name of event without the 'on' prefix (ex: 'log' to 'onLog' event declared)
- event: Function
  Unsubscriber Function, must be the one passed to on or once subscription methods
Returns boolean
Inherited from SIPConnector.off
- Defined in node_modules/@ceeblue/web-utils/dist/web-utils.d.ts:480

on

on(name, event, options?): void
Event subscription
Parameters
- name: "open" | "close" | "Close" | "Open"
  Name of event without the on prefix (ex: log to onLog event declared)
- event: Function
  Subscriber Function
- Optional options: {
  signal?: AbortSignal;
  }
  - Optional signal?: AbortSignal
    Optional AbortSignal to stop this or multiple subscriptions in same time
Returns void
Inherited from SIPConnector.on
- Defined in node_modules/@ceeblue/web-utils/dist/web-utils.d.ts:463

once

once(name, event, options?): void
Event subscription only one time, once time fired it's automatically unsubscribe
Parameters
- name: "open" | "close" | "Close" | "Open"
  Name of event without the on prefix (ex: log to onLog event declared)
- event: Function
  Subscriber Function
- Optional options: {
  signal?: AbortSignal;
  }
  - Optional signal?: AbortSignal
    Optional AbortSignal to stop this or multiple subscriptions in same time
Returns void
Inherited from SIPConnector.once
- Defined in node_modules/@ceeblue/web-utils/dist/web-utils.d.ts:472

replaceTrack

replaceTrack(kind, track): Promise<void>
Hot-swap a track on the existing RTCPeerConnection without renegotiation.
Parameters
- kind: "audio" | "video"
  'audio' | 'video'
- track: null | MediaStreamTrack
  A MediaStreamTrack to send, or null to stop sending that kind.
Returns Promise<void>
Inherited from SIPConnector.replaceTrack
- Defined in src/connectors/SIPConnector.ts:351

Events

onClose

onClose(error?): void
Call when connector is closed
Parameters
- Optional error: ConnectorError
  error description on an improper closure
Returns void
Inherited from SIPConnector.onClose
- Defined in src/connectors/SIPConnector.ts:73

onOpen

onOpen(stream): void
Call when connector is open
Parameters
- stream: MediaStream
  MediaStream description provided from the server if we are the player, or build from the local camera if we are the streamer.
Returns void
Inherited from SIPConnector.onOpen
- Defined in src/connectors/SIPConnector.ts:65

Class HTTPConnector

Example

Hierarchy

Index

Constructors

Properties

Accessors

Methods

Events

Constructors

constructor

Parameters

connectParams: Params

Optional stream: MediaStream

Returns HTTPConnector

Properties

Private _fetch

Private _url

log

Param

Returns

Accessors

closed

Returns boolean

codecs

Returns Set<string>

opened

Returns boolean

stream

Returns undefined | MediaStream

streamName

Returns string

Methods

Protected _open

Parameters

Optional iceServer: RTCIceServer

Returns void

Protected _sip

Parameters

offer: string

Returns Promise<string>

close

Parameters

Optional error: ConnectorError

Returns void

connectionInfos

Parameters

cacheDuration: number = 1000

Returns Promise<ConnectionInfos>

off

Parameters

name: "open" | "close" | "Close" | "Open"

event: Function

Returns boolean

on

Parameters

name: "open" | "close" | "Close" | "Open"

event: Function

Optional options: { signal?: AbortSignal; }

Optional signal?: AbortSignal

Returns void

once

Parameters

name: "open" | "close" | "Close" | "Open"

event: Function

Optional options: { signal?: AbortSignal; }

Optional signal?: AbortSignal

Returns void

replaceTrack

Parameters

kind: "audio" | "video"

track: null | MediaStreamTrack

Returns Promise<void>

Events

onClose

Parameters

Optional error: ConnectorError

Returns void

onOpen

Parameters

`Optional` stream: MediaStream

`Private` _fetch

`Private` _url

`Protected` _open

`Optional` iceServer: RTCIceServer

`Protected` _sip

`Optional` error: ConnectorError

`Optional` options: {
signal?: AbortSignal;
}

`Optional` signal?: AbortSignal

`Optional` options: {
signal?: AbortSignal;
}

`Optional` signal?: AbortSignal

`Optional` error: ConnectorError