Struct TurnProcessor 

pub struct TurnProcessor<T: TurnAnalyzer> { /* private fields */ }

A FrameProcessor that runs a TurnAnalyzer over the inbound audio and emits an end-of-turn MetricsData::TurnPrediction on each Frame::VadUserStoppedSpeaking edge.

It tracks the latest VAD state from Frame::VadUserStartedSpeaking/Frame::VadUserStoppedSpeaking and feeds each Frame::InputAudio window to the analyzer (so the silence/ML model sees the whole stream). The original frames are always forwarded; the turn-stop decision itself is owned by the TurnAnalyzerStop strategy in the cascaded turn controller, which consumes this metric.

Implementations

impl<T: TurnAnalyzer> TurnProcessor<T>

pub fn new(analyzer: T, sample_rate: u32, window_samples: usize) -> Self

Wrap analyzer, feeding window_samples-sample windows.

Trait Implementations

impl<T: TurnAnalyzer + 'static> FrameProcessor for TurnProcessor<T>

fn name(&self) -> &str

Stable, human-readable name (observer events, error attribution, tracing).

fn start<'life0, 'life1, 'life2, 'async_trait>( &'life0 mut self, _setup: &'life1 ProcessorSetup, params: &'life2 StartParams, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Called once when the Frame::Start frame reaches this processor, before any data frame. Open sockets / spawn provider readers here. Default: no-op.

fn can_generate_metrics(&self) -> bool

Whether this processor produces metrics (pipecat can_generate_metrics, :395). Services override to true.

fn process_frame<'life0, 'life1, 'async_trait>( &'life0 mut self, env: Envelope, link: &'life1 Link, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Handle one frame. Push results via link. Must not block: long work (a provider round-trip) is driven by an internally-spawned task that feeds results back as frames. The default impl forwards the frame unchanged in its direction — so a pure observer/no-op processor is process_frame = default.

fn stop<'life0, 'async_trait>( &'life0 mut self, _reason: StopReason, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Called on End/Stop/Cancel after the terminal frame is forwarded. Flush + close. Default: no-op.