rvoip-rtp-core 0.2.2

RTP/RTCP protocol implementation for the rvoip stack
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88

//! Event definitions
//!
//! This module defines common event types used by both client and server APIs.

use crate::api::client::transport::VoipMetrics;
use crate::api::common::stats::QualityLevel;
use std::net::SocketAddr;
use std::time::Duration;

/// Media transport event types for notifications
#[derive(Debug, Clone)]
pub enum MediaTransportEvent {
    /// Transport connected successfully
    Connected,
    /// Transport disconnected
    Disconnected,
    /// Network quality changed
    QualityChanged {
        /// The new quality level
        quality: QualityLevel,
    },
    /// New bandwidth estimate available
    BandwidthEstimate {
        /// Estimated available bandwidth in bits per second
        bps: u32,
    },
    /// Remote address changed (e.g., ICE candidate switch)
    RemoteAddressChanged {
        /// The new remote address
        address: SocketAddr,
    },
    /// Media frame received (only used when not using receive_frame directly)
    FrameReceived(crate::api::common::frame::MediaFrame),
    /// Error occurred
    Error(crate::api::common::error::MediaTransportError),
    /// Transport state changed
    StateChanged(String),
    /// Stream ended
    StreamEnded {
        /// Stream SSRC
        ssrc: u32,
        /// Reason for ending
        reason: String,
    },
    /// New stream detected
    NewStream {
        /// Stream SSRC
        ssrc: u32,
    },
    /// RTCP Report with quality statistics
    RtcpReport {
        /// Jitter in milliseconds
        jitter: f64,

        /// Packet loss ratio (0.0 - 1.0)
        packet_loss: f64,

        /// Round-trip time if available
        round_trip_time: Option<Duration>,
    },
    /// RTCP Application-Defined (APP) packet received
    RtcpAppReceived {
        /// SSRC of the sender
        ssrc: u32,

        /// Name of the application (4 ASCII characters)
        name: String,

        /// Application-specific data
        data: Vec<u8>,
    },
    /// RTCP Goodbye (BYE) packet received
    RtcpByeReceived {
        /// SSRC that is leaving
        ssrc: u32,

        /// Optional reason for leaving
        reason: Option<String>,
    },
    /// RTCP Extended Report (XR) with VoIP metrics received
    RtcpXrVoipMetrics {
        /// The VoIP metrics included in the XR packet
        metrics: VoipMetrics,
    },
}

/// Callback for receiving transport events
pub type MediaEventCallback = Box<dyn Fn(MediaTransportEvent) + Send + Sync>;