Struct RecordingSession 

pub struct RecordingSession {
    pub id: u64,
    pub started_at: Instant,
    pub started_at_unix_secs: u64,
    pub state: SessionState,
    pub streams: SessionStreams,
}

One coordinated recording session — the orchestrator owned by RecordingState (M-RECORD.1) for the lifetime of one start → stop cycle.

Construction is staged so the Tauri-side start_recording command can do the heavy lifting (spawn per-channel pipelines, roll back on per-stream failure) without mutating session state mid-failure:

1. RecordingSession::starting(streams) — allocates the session id, captures Instant::now() as started_at, sets state to Starting. No pipelines spawned yet.
2. Caller spawns each enabled per-channel pipeline; on any failure, calls RecordingSession::abort() and returns Err(...).
3. Once all enabled streams have reported their first frame, RecordingSession::mark_running() flips state to Running.
4. On stop_recording, RecordingSession::begin_stop() flips to Stopping; caller tears down per-channel pipelines.
5. RecordingSession::finish_stop() flips back to Idle.

Fields

id: u64

Unique-per-process session id. Stamped on every emitted recording-status event so a delayed event from a prior session can be filtered.

started_at: Instant

Shared monotonic clock — every per-frame PTS pushed into the M-EXPORT encoder is computed as Instant::now() - started_at. Captured ONCE here so all four streams share the same origin.

started_at_unix_secs: u64

Wall-clock start time (Unix epoch seconds). Complements the monotonic started_at; M-SAVE.1 carries it through to export so the Screen-YYYY-MM-DD-HHMMSS.<ext> filename reflects when the recording started, not when the user clicked Export.

state: SessionState

Master lifecycle.

streams: SessionStreams

Which channels are part of this session.

Implementations

impl RecordingSession

pub fn starting(streams: SessionStreams) -> Self

Begin a new session — allocates an id, captures the start time, sets state to Starting. Caller is responsible for spawning the enabled per-channel pipelines.

pub fn mark_running(&mut self)

Mark the session Running. Called by M-RECORD.1 once all enabled streams have produced their first frame. Idempotent.

pub fn begin_stop(&mut self)

Begin tearing down — Starting | Running → Stopping. Idempotent on Stopping; no-op on Idle.

pub fn finish_stop(&mut self)

Finish teardown — Stopping → Idle. Idempotent on Idle; no-op on Starting | Running (the begin_stop step has to happen first).

pub fn abort(&mut self)

Hard-abort the session — flip state straight to Idle regardless of where it was. Used by M-RECORD.1 to roll back when a per-channel start failed mid-Starting and the partial pipelines have been torn down.

pub fn elapsed(&self) -> Duration

Elapsed time since started_at. Used by M-RECORD.2’s mm:ss display + by M-EXPORT’s PTS math.

Trait Implementations

impl Clone for RecordingSession

fn clone(&self) -> RecordingSession

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RecordingSession

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

Formats the value using the given formatter.

impl PartialEq for RecordingSession

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for RecordingSession

impl StructuralPartialEq for RecordingSession