Skip to navigation

Endpoint

Represents any remote media unit in a session.
View as Markdown

Represents any remote media unit in a session. An endpoint can be represented as ASR, Recorder, Player or another Call. Add the following line to your scenario code to use the class:

require(Modules.Conference);

Methods

getCall

Returns the endpoint’s Call instance if the endpoint is not a player or recorder instance.

getCall(): Call

getDirection

Returns the endpoint’s direction. SEND provides only outgoing stream from endpoint to conference, RECEIVE provides only incoming stream from conference to endpoint, BOTH allows both incoming and outgoing streams.

getDirection(): 'SEND' | 'RECEIVE' | 'BOTH'

getMode

Returns the endpoint’s mode. MIX mode combines all streams in one, FORWARD mode sends only one stream.

getMode(): 'MIX' | 'FORWARD'

id

Returns the endpoint’s id.

id(): string

manageEndpoint

Enables/disables receiving media streams from other conference participants.

manageEndpoint(parameters: ReceiveParameters): Promise<void>

Parameters

parameters
ReceiveParametersRequired

An object that specifies what media streams to receive from each Endpoint. Can be passed via the EndpointParameters.receiveParameters parameter or an argument to the Endpoint.manageEndpoint method. The object can accept the following keys:

A string value with the endpoint ID. Applies the setting only for the specified endpoint. The all keyword. Applies the setting for all the endpoints. The new keyword. Applies the setting for the new endpoints only.

parameters[remoteParticipantId]
ParticipantReceiveParameters

index signature

Substitute one of the available keys from the description.

parameters[remoteParticipantId].video
Array<'default' | string>

optional

Optional. Video streams to receive.

parameters[remoteParticipantId].audio
Array<'default' | string>

optional

Optional. Audio streams to receive.

setDisplayName

Sets the display name for the specified endpoint. When the display name is set, all SDK clients receive ‘EndpointEvents.InfoUpdated’ event.

setDisplayName(displayName: string): void

Parameters

displayName
stringRequired