Skip to main content

Class: LocalPeer

Represents the local peer connected to a room. This class extends the base Peer class and includes functionality specific to the local peer, such as adjusting audio input volumes and managing user data.

Extends

Constructors

new LocalPeer()

new LocalPeer(_peerData, room): LocalPeer

Parameters

_peerData

_peerData.id: number

_peerData.medias: object[]

_peerData.user_data: Uint8Array

_peerData.user_id: string

room: Room

Returns

LocalPeer

Overrides

Peer.constructor

Defined in

ari/lib/api/peer/local-peer.d.ts:50

Properties

_peerData

protected _peerData: object

id

id: number

medias

medias: object[]

user_data

user_data: Uint8Array

user_id

user_id: string

Overrides

Peer._peerData

Defined in

ari/lib/api/peer/local-peer.d.ts:12


audioActivityHandler()

readonly audioActivityHandler: (event) => void

This method is for SDK internal usage and might get removed.

Parameters

event: OdinEvent<AudioActivityPayload>

The audio activity event containing relevant payload data.

Returns

void

Deprecated

Inherited from

Peer.audioActivityHandler

Defined in

ari/lib/api/peer/index.d.ts:30


id

readonly id: number

Inherited from

Peer.id

Defined in

ari/lib/api/peer/index.d.ts:12


isRemote

readonly isRemote: false = false

Defined in

ari/lib/api/peer/local-peer.d.ts:14


onAudioActivity()?

optional onAudioActivity: (payload) => void

A callback function that is invoked when audio activity occurs and voice activity detection (VAD) was set to true.

Parameters

payload: AudioActivityPayload

An object containing the AudioMedia.

Returns

void

Inherited from

Peer.onAudioActivity

Defined in

ari/lib/api/peer/index.d.ts:36


onAudioInputStarted()?

optional onAudioInputStarted: (payload) => void

A callback function that gets invoked when an AudioInput was started.

Parameters

payload: AudioInputPayload

An object containing the AudioInput that was started.

Returns

void

Inherited from

Peer.onAudioInputStarted

Defined in

ari/lib/api/peer/index.d.ts:62


onAudioInputStopped()?

optional onAudioInputStopped: (payload) => void

A callback function that gets invoked when an AudioInput was stopped.

Parameters

payload: AudioInputPayload

An object containing the AudioInput that was stopped.

Returns

void

Inherited from

Peer.onAudioInputStopped

Defined in

ari/lib/api/peer/index.d.ts:80


onAudioOutputStarted()?

optional onAudioOutputStarted: (payload) => void

A callback function that gets invoked when an AudioOutput was started.

Parameters

payload: AudioOutputPayload

An object containing the AudioOutput that was started.

Returns

void

Inherited from

Peer.onAudioOutputStarted

Defined in

ari/lib/api/peer/index.d.ts:86


onAudioOutputStopped()?

optional onAudioOutputStopped: (payload) => void

A callback function that gets invoked when an AudioOutput was stopped.

Parameters

payload: AudioOutputPayload

An object containing the AudioOutput that was stopped.

Returns

void

Inherited from

Peer.onAudioOutputStopped

Defined in

ari/lib/api/peer/index.d.ts:92


onMediaStarted()?

optional onMediaStarted: (payload) => void

A callback function that gets invoked when a new audio or video media was started.

Parameters

payload: MediaPayload

An object containing the media that was started.

Returns

void

Inherited from

Peer.onMediaStarted

Defined in

ari/lib/api/peer/index.d.ts:50


onMediaStopped()?

optional onMediaStopped: (payload) => void

A callback function that gets invoked when an audio or video media was stopped.

Parameters

payload: MediaPayload

An object containing the media that was stopped.

Returns

void

Inherited from

Peer.onMediaStopped

Defined in

ari/lib/api/peer/index.d.ts:56


onPowerLevel()?

optional onPowerLevel: (payload) => void

A callback function invoked when there is an update to the audio power level in rmsDBFS. This function can be used to handle or process audio activity, such as monitoring sound levels or visualizing audio input.

Parameters

payload: AudioActivityPayload

An object containing the AudioMedia.

Returns

void

Inherited from

Peer.onPowerLevel

Defined in

ari/lib/api/peer/index.d.ts:44


onUserDataChanged()?

optional onUserDataChanged: (payload) => void

A callback function invoked when user data is changed.

Parameters

payload: UserDataChangedPayload

An object containing the peer and the room.

Returns

void

Inherited from

Peer.onUserDataChanged

Defined in

ari/lib/api/peer/index.d.ts:110


onVideoInputStarted()?

optional onVideoInputStarted: (payload) => void

A callback function that gets invoked when a VideoInput was started.

Parameters

payload: VideoInputPayload

An object containing the VideoInput that was started.

Returns

void

Inherited from

Peer.onVideoInputStarted

Defined in

ari/lib/api/peer/index.d.ts:68


onVideoInputStopped()?

optional onVideoInputStopped: (payload) => void

A callback function that gets invoked when a VideoInput was stopped.

Parameters

payload: VideoInputPayload

An object containing the VideoInput that was stopped.

Returns

void

Inherited from

Peer.onVideoInputStopped

Defined in

ari/lib/api/peer/index.d.ts:74


onVideoOutputStarted()?

optional onVideoOutputStarted: (payload) => void

A callback function that gets invoked when a VideoOutput was started.

Parameters

payload: VideoOutputPayload

An object containing the VideoOutput that was started.

Returns

void

Inherited from

Peer.onVideoOutputStarted

Defined in

ari/lib/api/peer/index.d.ts:98


onVideoOutputStopped()?

optional onVideoOutputStopped: (payload) => void

A callback function that gets invoked when a VideoOutput was stopped.

Parameters

payload: VideoOutputPayload

An object containing the VideoOutput that was stopped.

Returns

void

Inherited from

Peer.onVideoOutputStopped

Defined in

ari/lib/api/peer/index.d.ts:104


rmsDBFSHandler()

readonly rmsDBFSHandler: (event) => void

This method is for SDK internal usage and might get removed.

Parameters

event: OdinEvent<AudioActivityPayload>

The audio event containing the payload with RMS power level information.

Returns

void

Deprecated

Inherited from

Peer.rmsDBFSHandler

Defined in

ari/lib/api/peer/index.d.ts:23


room

readonly room: Room

Overrides

Peer.room

Defined in

ari/lib/api/peer/local-peer.d.ts:13


userId

readonly userId: string

The userId that was provided by the token when joining the room.

Inherited from

Peer.userId

Defined in

ari/lib/api/peer/index.d.ts:16

Accessors

audioInputs

get audioInputs(): AudioInput[]

Retrieves the list of AudioInput devices associated with this Peer.

Returns

AudioInput[]

An array of AudioInput objects. Returns an empty array if the instance is remote.

Defined in

ari/lib/api/peer/local-peer.d.ts:39


data

get data(): Uint8Array

The arbitrary user data of the peer.

set data(data): void

Set updated user data for the peer.

Parameters

data: Uint8Array

Returns

Uint8Array

The appropriate Uint8Array data based on the context.

Defined in

ari/lib/api/peer/local-peer.d.ts:49


isActive

get isActive(): boolean

Determines if any of the audio inputs are currently active.

Returns

boolean

True if at least one audio input is active, otherwise false.

Defined in

ari/lib/api/peer/local-peer.d.ts:27


powerLevel

get powerLevel(): number

Retrieves the highest power level among the audio inputs.

Returns

number

The highest power level detected across all audio inputs.

Defined in

ari/lib/api/peer/local-peer.d.ts:33


volume

get volume(): InputVolume

Gets the current volume of the LocalPeer.

Returns

InputVolume

The current volume.

Defined in

ari/lib/api/peer/local-peer.d.ts:21

Methods

addEventListener()

addEventListener<OdinEventType>(eventName, handler, options?): void

Type Parameters

OdinEventType extends keyof PeerEvents

Parameters

eventName: OdinEventType

handler: PeerEvents[OdinEventType]

options?: boolean | AddEventListenerOptions

Returns

void

Inherited from

Peer.addEventListener

Defined in

ari/lib/utils/odin-event-target.d.ts:26


dispatchEvent()

dispatchEvent<T>(event): void

Type Parameters

T extends OdinEvent<any>

Parameters

event: T

Returns

void

Inherited from

Peer.dispatchEvent

Defined in

ari/lib/utils/odin-event-target.d.ts:27


removeEventListener()

removeEventListener<OdinEventType>(type, callback): void

Type Parameters

OdinEventType extends keyof PeerEvents

Parameters

type: string | OdinEventType

callback: EventListenerOrEventListenerObject | PeerEvents[OdinEventType]

Returns

void

Inherited from

Peer.removeEventListener

Defined in

ari/lib/utils/odin-event-target.d.ts:28


setVolume()

setVolume(value): Promise<void>

Sets the volume for all associated Medias of this Peer.

Parameters

value: InputVolume

The new volume level to set.

Returns

Promise<void>

A promise that resolves when the volume is set for all medias.

Defined in

ari/lib/api/peer/local-peer.d.ts:57


update()

update(): Promise<void>

Updates the current user's data by flushing it to the associated room.

Returns

Promise<void>

Resolves when the user data has been successfully updated, or rejects with an error if the user is a remote peer or if the operation encounters an issue.

Defined in

ari/lib/api/peer/local-peer.d.ts:63