pub struct RtpReader<'a> { /* private fields */ }Expand description
Wrapper around a byte-slice of RTP data, providing accessor methods for the RTP header fields.
Implementations§
Source§impl<'a> RtpReader<'a>
impl<'a> RtpReader<'a>
Sourcepub const MIN_HEADER_LEN: usize = 12usize
pub const MIN_HEADER_LEN: usize = 12usize
An RTP packet header is no fewer than 12 bytes long
Sourcepub fn new(b: &'a [u8]) -> Result<RtpReader<'_>, RtpReaderError>
pub fn new(b: &'a [u8]) -> Result<RtpReader<'_>, RtpReaderError>
Tries to construct a new RtpHeader instance, or an RtpReaderError if the RTP data is
malformed.
In particular, if there is too little data in the given buffer, such that some later attempt to access an RTP header field would need to access bytes that are not available, then this method will fail up front, rather than allowing attempts to access any header field to fail later on.
Sourcepub fn version(&self) -> u8
pub fn version(&self) -> u8
Version field value (currently only version 2 is supported, so other values will not be
seen from this release of rtp-rs.
Sourcepub fn padding(&self) -> Option<u8>
pub fn padding(&self) -> Option<u8>
Returns the size of the padding at the end of this packet, or None if the padding flag is
not set in the packet header
Sourcepub fn csrc_count(&self) -> u8
pub fn csrc_count(&self) -> u8
A count of the number of CSRC fields present in the RTP headers - may be 0.
See csrc().
Sourcepub fn mark(&self) -> bool
pub fn mark(&self) -> bool
A ‘marker’, which may have some definition in the specific RTP profile in use
Sourcepub fn payload_type(&self) -> u8
pub fn payload_type(&self) -> u8
Indicates the type of content carried in this RTP packet.
A few types-values are defined in the standard, but in many applications of RTP the value of this field needs to be agreed between sender and receiver by some mechanism outside of RTP itself.
Sourcepub fn sequence_number(&self) -> Seq
pub fn sequence_number(&self) -> Seq
The sequence number of this particular packet.
Sequence numbers are 16 bits, and will wrap back to 0 after reaching the maximum 16-bit
value of 65535.
Receivers can identify packet losses or reordering by inspecting the value of this field
across a sequence of received packets. The Seq wrapper type helps
calling code reason about sequence number problems in the face of any wraparound that might
have legitimately happened.
Sourcepub fn timestamp(&self) -> u32
pub fn timestamp(&self) -> u32
The timestamp of this packet, given in a timebase that relates to the particular
payload_type in use.
It is perfectly possible for successive packets in a sequence to have the same value, or to have values that differ by arbitrarily large amounts.
Timestamps are 32 bits, and will wrap back to 0 after reaching the maximum 32 bit value
of 4294967295.
Sourcepub fn ssrc(&self) -> u32
pub fn ssrc(&self) -> u32
The synchronisation source for this packet. Many applications of RTP do not use this field.
Sourcepub fn csrc(&self) -> impl Iterator<Item = u32> + '_
pub fn csrc(&self) -> impl Iterator<Item = u32> + '_
A potentially empty list of contributing sources for this packet. Many applications of RTP do not use this field.
Sourcepub fn payload_offset(&self) -> usize
pub fn payload_offset(&self) -> usize
Returns the offset of the payload for the packet
Sourcepub fn payload(&self) -> &'a [u8] ⓘ
pub fn payload(&self) -> &'a [u8] ⓘ
Returns the payload data of this RTP packet, excluding the packet’s headers and any optional trailing padding.
Sourcepub fn extension(&self) -> Option<(u16, &'a [u8])>
pub fn extension(&self) -> Option<(u16, &'a [u8])>
Returns details of the optional RTP header extension field. If there is an extension, the first component of the resulting tuple is the extension id, and the second is a byte-slice for the extension data value, to be interpreted by the application.
Sourcepub fn create_builder(&self) -> RtpPacketBuilder<'a>
pub fn create_builder(&self) -> RtpPacketBuilder<'a>
Create a RtpPacketBuilder from this packet. Note that padding from the original
packet will not be used by default, and must be defined on the resulting RtpPacketBuilder
if required.
The padding is not copied from the original since, while we do know how many padding bytes were present, we don’t know if the intent was to round to 2 bytes, 4 bytes, etc. Blindly copying the padding could result in an incorrect result if the payload is subsequently changed for one with a different length.
If you know your output packets don’t need padding, there is nothing more to do, since
that is the default for the resulting RtpPacketBulder.
If you know you output packets need padding to 4 bytes, then you must explicitly specify
this using builder.padded(Pad::round_to(4)) even if the source packet was already padded
to a 4 byte boundary.