Enum Role 

pub enum Role {
    Controlling,
    Controlled,
}

Which end decides (§6.1.1).

Variants

Controlling

Responsible for nominating the pairs that become the selected pairs.

Controlled

Answers checks and follows the controlling agent’s nomination.

Implementations

impl Role

pub const fn determine(offerer: bool, remote_lite: bool) -> Self

§6.1.1’s role determination, for an agent that is always full (spec §12).

Both full: the initiating agent controls. Full against lite: the full agent controls, unconditionally — which is why the peer’s a=ice-lite is an input here and not a detail for the driver.

“The offerer controls” is the right answer and the wrong mechanism: two agents can both believe they offered — third-party call control, glare, a re-INVITE crossing — and two controlling agents never converge, because neither will accept the other’s nomination. §7.3.1.1 is what repairs that, and it is why this function is not the last word on the role.

pub const fn opposite(self) -> Self

The other role. A 487 switches to it (§7.2.5.1), as does the losing side of §7.3.1.1.

pub const fn is_controlling(self) -> bool

Whether this is the controlling role.

Trait Implementations

impl Clone for Role

fn clone(&self) -> Role

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Role

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

Formats the value using the given formatter.

impl Hash for Role

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Role

fn eq(&self, other: &Role) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for Role

impl Eq for Role

impl StructuralPartialEq for Role