xmpp-rs/parsers/src/jingle_rtp_hdrext.rs
2024-07-25 18:42:18 +02:00

92 lines
2.5 KiB
Rust
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

// Copyright (c) 2020 Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
//
// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
// file, You can obtain one at http://mozilla.org/MPL/2.0/.
use xso::{AsXml, FromXml};
use crate::ns;
generate_attribute!(
/// Which party is allowed to send the negotiated RTP Header Extensions.
Senders, "senders", {
/// Both parties can send them.
Both => "both",
/// Only the initiator can send them.
Initiator => "initiator",
/// Only the responder can send them.
Responder => "responder",
}, Default = Both
);
/// Header extensions to be used in a RTP description.
#[derive(FromXml, AsXml, PartialEq, Debug, Clone)]
#[xml(namespace = ns::JINGLE_RTP_HDREXT, name = "rtp-hdrext")]
pub struct RtpHdrext {
/// The ID of the extensions. The allowed values are only in the 1-256, 4096-4351 ranges,
/// this isnt enforced by xmpp-parsers yet!
// TODO: make it so.
#[xml(attribute)]
pub id: u16,
/// The URI that defines the extension.
#[xml(attribute)]
pub uri: String,
/// Which party is allowed to send the negotiated RTP Header Extensions.
#[xml(attribute(default))]
pub senders: Senders,
}
impl RtpHdrext {
/// Create a new RTP header extension element.
pub fn new(id: u16, uri: String) -> RtpHdrext {
RtpHdrext {
id,
uri,
senders: Default::default(),
}
}
/// Set the senders.
pub fn with_senders(mut self, senders: Senders) -> RtpHdrext {
self.senders = senders;
self
}
}
#[cfg(test)]
mod tests {
use super::*;
use minidom::Element;
#[cfg(target_pointer_width = "32")]
#[test]
fn test_size() {
assert_size!(Senders, 1);
assert_size!(RtpHdrext, 16);
}
#[cfg(target_pointer_width = "64")]
#[test]
fn test_size() {
assert_size!(Senders, 1);
assert_size!(RtpHdrext, 32);
}
#[test]
fn parse_exthdr() {
let elem: Element = "<rtp-hdrext xmlns='urn:xmpp:jingle:apps:rtp:rtp-hdrext:0'
uri='urn:ietf:params:rtp-hdrext:toffset'
id='1'/>"
.parse()
.unwrap();
let rtp_hdrext = RtpHdrext::try_from(elem).unwrap();
assert_eq!(rtp_hdrext.id, 1);
assert_eq!(rtp_hdrext.uri, "urn:ietf:params:rtp-hdrext:toffset");
assert_eq!(rtp_hdrext.senders, Senders::Both);
}
}