Enum PlaybackEvent 

#[non_exhaustive]
pub enum PlaybackEvent {
    Loaded,
    Ended {
        reason: EndReason,
    },
    PlaybackRestart,
    PropertyChanged {
        id: ObserveId,
        name: String,
        value: PropertyValue,
    },
    Shutdown,
    Failed {
        code: i32,
        message: String,
    },
}

Playback lifecycle notifications drained by Engine::pump_events.

Non-exhaustive: match with a wildcard arm — new variants are additive, not breaking.

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.

Loaded

A file finished loading and playback is starting.

Ended

Playback ended without error. Errored ends arrive as Failed instead.

Fields

reason: EndReason

Why it ended — playlist logic usually advances on EndReason::Eof and holds on EndReason::Stop.

PlaybackRestart

Playback (re)started after a seek completed or a file began playing: the displayed frame matches time-pos again. Snap scrubber/position UI here, not while a seek is still in flight.

PropertyChanged

An observed property changed (Engine::observe); also fires once with the current value right after observation starts.

Fields

id: ObserveId

Which observation this notification belongs to — matches the ObserveId returned by Engine::observe, so two observations of the same property stay distinguishable.

name: String

The mpv property name, as passed to Engine::observe.

value: PropertyValue

The new value, in the PropertyFormat the observation chose.

Shutdown

The mpv core is shutting down — e.g. a quit issued through Engine::command, or an input binding if input was enabled. No further events follow; drop the Engine soon. (A file that was playing also gets an Ended with EndReason::Quit first.)

Failed

mpv aborted playback — unreadable, corrupt, empty, or an unrecognized/unsupported format.

Fields

code: i32

Raw client.h mpv_error code (always negative). Match on this to map failures to your own user-facing error copy.

message: String

Diagnostic text (mpv’s mpv_error_string plus the code), not user-facing copy.

Trait Implementations

impl Clone for PlaybackEvent

fn clone(&self) -> PlaybackEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PlaybackEvent

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

Formats the value using the given formatter.

impl PartialEq for PlaybackEvent

fn eq(&self, other: &PlaybackEvent) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for PlaybackEvent