Enum Error 

#[non_exhaustive]
pub enum Error {
    Unsupported(String),
    Device(String),
    Capture(String),
    Playback(String),
    Busy(String),
    Decode(String),
    Misaligned {
        got: usize,
        expected: usize,
    },
    ResamplerConstruction(String),
    Resample(String),
    Hang(Error),
    Mux(Error),
    Net(Error),
    TimeOverflow(TimeOverflow),
}

Errors returned by moq-audio.

Clone so a failure can be reported to more than one observer, matching hang::Error, moq_mux::Error, and moq_net::Error.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Unsupported(String)

The requested configuration is outside what the codec or device supports, e.g. a sample rate, channel count, or frame duration Opus can’t encode, or a capture format the microphone can’t deliver. The caller asked for something impossible; picking different settings fixes it.

Device(String)

No audio device matched the requested selector, or the machine has no default input. Retrying won’t help until the device list changes; capture::devices reports what is available.

Capture(String)

The capture backend failed or delivered nothing: a denied permission, a device that stopped mid-stream, or a host API error. The configuration may be fine; the device or its permissions are not.

Playback(String)

The playback backend failed: the output device could not be opened, or the stream stopped and could not be restarted. The device or host API is at fault, not the configuration; playback::devices reports what is available.

Busy(String)

Exclusive audio processing state is already owned by another live capture or playback handle.

Decode(String)

A packet could not be decoded: truncated, corrupt, or using a codec feature this build doesn’t implement. The stream itself may be fine, so a consumer can log this one and read the next packet.

Misaligned

The input buffer was not aligned to the codec’s frame size.

Fields

got: usize

The buffer length received, in bytes.

expected: usize

The buffer length required, in bytes.

ResamplerConstruction(String)

The sample-rate converter could not be constructed.

Resample(String)

The sample-rate converter rejected an input buffer or ratio change.

Hang(Error)

hang catalog error.

Mux(Error)

moq-mux container/transport error.

Net(Error)

moq-net transport error.

TimeOverflow(TimeOverflow)

Timestamp overflow.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Error

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for Error

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for Error

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<TimeOverflow> for Error

fn from(source: TimeOverflow) -> Self

Converts to this type from the input type.