Struct ReceiverRuntime 

pub struct ReceiverRuntime { /* private fields */ }

Shared receive runtime for OpenIPC video plus optional raw payload taps.

This is the easiest core entry point for apps. It accepts Realtek RX transfers, 802.11 frames, or already-decrypted fragments; routes recovered WFB payloads by route id; and depacketizes the configured video route from RTP into Annex-B H.264/H.265 frames.

Implementations

impl ReceiverRuntime

pub fn from_routes( routes: PayloadRouteManager, video_runtime: PayloadRuntimeKey, video_route_id: PayloadRouteId, ) -> Self

Build a runtime around an existing route manager.

video_runtime and video_route_id identify the route whose recovered payloads are RTP video and should be depacketized into frames.

pub fn with_plain_video_route( frame_layout: FrameLayout, video_route_id: PayloadRouteId, channel_id: ChannelId, key_slot: u64, fec_k: usize, fec_n: usize, ) -> Result<Self, PayloadRouteError>

Create a runtime with an unencrypted/plain video route.

This is mainly useful for tests and pre-decrypted captures.

pub fn with_keyed_video_route( frame_layout: FrameLayout, video_route_id: PayloadRouteId, channel_id: ChannelId, key_slot: u64, keypair: WfbKeypair, minimum_epoch: u64, ) -> Result<Self, PayloadRouteError>

Create a runtime with an encrypted WFB video route.

pub const fn video_runtime(&self) -> PayloadRuntimeKey

Return the route-manager runtime key used for video.

pub const fn video_route_id(&self) -> PayloadRouteId

Return the application route id used for video.

pub fn routes(&self) -> &PayloadRouteManager

Borrow the underlying route manager.

pub fn routes_mut(&mut self) -> &mut PayloadRouteManager

Mutably borrow the underlying route manager.

pub fn rtp_mut(&mut self) -> &mut RtpDepacketizer

Mutably borrow the RTP depacketizer for advanced video handling.

pub fn add_plain_route( &mut self, route_id: PayloadRouteId, channel_id: ChannelId, key_slot: u64, fec_k: usize, fec_n: usize, ) -> Result<PayloadRuntimeKey, PayloadRouteError>

Add an unencrypted/plain raw-payload route.

pub fn add_keyed_route( &mut self, route_id: PayloadRouteId, channel_id: ChannelId, key_slot: u64, keypair: WfbKeypair, minimum_epoch: u64, ) -> Result<PayloadRuntimeKey, PayloadRouteError>

Add an encrypted WFB raw-payload route.

pub fn video_fec_counters(&self) -> FecCounters

Return cumulative FEC counters for the video runtime.

pub fn accepts_video_frame(&self, frame: &[u8]) -> bool

Return true if an 802.11 frame belongs to the configured video runtime.

pub fn push_rx_transfer( &mut self, transfer: &[u8], options: &ReceiverBatchOptions, ) -> Result<ReceiverBatch, AggregateError>

Parse and process one Realtek USB RX transfer.

pub fn push_rx_packets<'a>( &mut self, packets: impl IntoIterator<Item = RealtekRxPacket<'a>>, options: &ReceiverBatchOptions, ) -> ReceiverBatch

Process already parsed Realtek RX packets.

pub fn push_80211_frame( &mut self, frame: &[u8], options: &ReceiverBatchOptions, ) -> Result<ReceiverBatch, PayloadRouteError>

Process one OpenIPC/WFB 802.11 frame.

pub fn push_decrypted_80211_frame( &mut self, runtime: PayloadRuntimeKey, frame: &[u8], decrypted_fragment: &[u8], options: &ReceiverBatchOptions, ) -> Result<ReceiverBatch, PayloadRouteError>

Process one 802.11 frame when the caller already decrypted the WFB fragment.

pub fn push_decrypted_fragment( &mut self, runtime: PayloadRuntimeKey, data_nonce: u64, decrypted_fragment: &[u8], options: &ReceiverBatchOptions, ) -> Result<ReceiverBatch, PayloadRouteError>

Process one already-decrypted WFB fragment.

Trait Implementations

impl Clone for ReceiverRuntime

fn clone(&self) -> ReceiverRuntime

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ReceiverRuntime

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

Formats the value using the given formatter.