Class VoiceMedia

The voice of a call: the microphone's frames encoded with Opus and sent over a peer connection, and the frames received put in order by a jitter buffer, decoded, and played as the speaker needs them.

Inheritance

object

VoiceMedia

Implements

IAsyncDisposable

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.ReferenceEquals(object, object)

object.ToString()

Namespace: Uniform.Matrix.Calls

Assembly: Uniform.Matrix.Calls.dll

Syntax

public sealed class VoiceMedia : IAsyncDisposable

Remarks

The speaker's clock paces playing: a timer tops up its buffer to SpeakerTarget, one frame at a time from the jitter buffer, concealing lost ones. So the sender's and the speaker's clocks may drift apart without the delay growing.

Constructors

VoiceMedia(IMediaConnection, IAudioDevices)

Open the devices for a connection; nothing records or plays until Start().

Declaration

public VoiceMedia(IMediaConnection connection, IAudioDevices devices)

Parameters

Type	Name	Description
IMediaConnection	connection
IAudioDevices	devices

Fields

SpeakerTarget

How much audio the speaker is kept queued.

Declaration

public static readonly TimeSpan SpeakerTarget

Field Value

Type	Description
TimeSpan

Properties

Lost

Frames received that were lost, and concealed.

Declaration

public long Lost { get; }

Property Value

Type	Description
long

Muted

Whether the microphone is muted; muted frames are not sent, and the next one sent is marked.

Declaration

public bool Muted { get; set; }

Property Value

Type	Description
bool

Received

Frames received.

Declaration

public long Received { get; }

Property Value

Type	Description
long

Sent

Frames sent.

Declaration

public long Sent { get; }

Property Value

Type	Description
long

Underruns

Frames concealed while waiting for a late packet.

Declaration

public long Underruns { get; }

Property Value

Type	Description
long

Methods

DisposeAsync()

Stop, and close the devices.

Declaration

public ValueTask DisposeAsync()

Returns

Type	Description
ValueTask

Start()

Start recording and playing.

Declaration

public void Start()

Events

DeviceFailed

Raised when a device fails while the call plays or records, e.g. a speaker that stops.

Declaration

public event Action<Exception>? DeviceFailed

Event Type

Type	Description
Action<Exception>

Implements

IAsyncDisposable