Struct Agent

pub struct Agent { /* private fields */ }

An ICE agent as specified in RFC 8445

Implementations

impl Agent

pub fn builder() -> AgentBuilder

Create a new AgentBuilder

pub fn id(&self) -> u64

The identifier for this Agent

pub fn add_stream(&mut self) -> usize

Add a new Stream to this agent

Examples

Add a Stream

let mut agent = Agent::default();
let s = agent.add_stream();

pub fn close(&mut self, now: Instant)

Close the agent loop. Applications should wait for Agent::poll to return AgentPoll::Closed after calling this function.

pub fn controlling(&self) -> bool

The controlling state of this ICE agent. This value may change throughout the ICE negotiation process.

pub fn add_stun_server(&mut self, transport: TransportType, addr: SocketAddr)

Add a STUN server by address and transport to use for gathering potential candidates

pub fn stun_servers(&self) -> &Vec<(TransportType, SocketAddr)>

The current list of STUN servers used by this Agent

pub fn add_turn_server( &mut self, transport: TransportType, addr: SocketAddr, credentials: TurnCredentials, )

pub fn turn_servers(&self) -> &Vec<(TransportType, SocketAddr, TurnCredentials)>

The current list of STUN servers used by this Agent

pub fn stream(&self, id: usize) -> Option<Stream<'_>>

Get a Stream by id.

If the stream does not exist, then None will be returned.

pub fn mut_stream(&mut self, id: usize) -> Option<StreamMut<'_>>

Get a StreamMut by id. If the stream does not exist, then None will be returned.

pub fn poll(&mut self, now: Instant) -> AgentPoll

Poll the Agent for further progress to be made. The returned value indicates what the application needs to do.

pub fn poll_transmit(&mut self, now: Instant) -> Option<AgentTransmit>

Poll for a transmission to be performed.

If not-None, then the provided data must be sent to the peer from the provided socket address.

Trait Implementations

impl Debug for Agent

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

Formats the value using the given formatter.

impl Default for Agent

fn default() -> Self

Returns the “default value” for a type.