Struct MediaFrameRegistry 

pub struct MediaFrameRegistry { /* private fields */ }

MediaFrameRegistry - WebRTC native media track callback manager

Architecture

MediaFrameRegistry works with WebRTC PeerConnection to receive native media:

WebRTC PeerConnection
  └─ RTCTrackRemote (native RTP channel)
      └─ on_track callback
          └─ MediaFrameRegistry::dispatch()
              └─ User callback (MediaSample, sender_id)

Key Points

• No protobuf: Uses WebRTC native sample data
• No DataChannel: Media goes through RTCTrackRemote (RTP)
• Zero serialization: Direct sample bytes from RTP packets
• Low latency: ~1-2ms from network to callback

Typical Use Cases

• Real-time audio/video calls
• Screen sharing
• Audio/video recording
• Media transcoding

Implementations

impl MediaFrameRegistry

pub fn new() -> Self

pub fn register(&self, track_id: String, callback: MediaTrackCallback)

Register media track callback

Arguments

• track_id: Track identifier (must be globally unique)
• callback: Media sample handler callback

Example

registry.register("video-track-1", Arc::new(|sample, sender| {
    Box::pin(async move {
        println!("Received {} bytes from {:?}", sample.data.len(), sender);
        // Decode and render video frame...
        Ok(())
    })
}));

pub fn unregister(&self, track_id: &str)

Unregister media track callback

Arguments

• track_id: Track identifier to unregister

pub async fn dispatch( &self, track_id: &str, sample: MediaSample, sender_id: ActrId, )

Dispatch media sample to callback (concurrent execution)

Called by WebRTC on_track handler when a media sample arrives.

Arguments

• track_id: Track identifier
• sample: Media sample from RTCTrackRemote
• sender_id: Sender ActrId

Performance

• Direct callback invocation, no queueing overhead
• Latency: ~1-2μs dispatch time (excluding callback execution)
• Concurrent execution, doesn’t block other tracks

pub fn active_tracks(&self) -> usize

Get active track count

Trait Implementations

impl Default for MediaFrameRegistry

fn default() -> Self

Returns the “default value” for a type.