Struct EarlyCoupling 

pub struct EarlyCoupling { /* private fields */ }

Two pending user-agent legs owned from an early dialog through confirmation or failure.

Implementations

impl EarlyCoupling

pub async fn dial( invitation: Invitation, calls: &Calls, endpoint: &Handle, target: Target, to: &Uri, options: &DialOptions, media_address: IpAddr, ) -> Result<Self>

Consume an inbound invitation and create its relayed target leg under one owner.

Target selection remains application policy. The coupling maps the source offer’s audio direction onto fresh target-leg SDP; endpoint addresses, ports and key material are never copied between the two user-agent dialogs.

pub fn new( invitation: Invitation, ringing: Ringing, dialing: Dialing, outgoing_incoming: Receiver<Incoming>, endpoint: &Handle, media_address: IpAddr, ) -> Self

Join an inbound invitation already rung to its pending outbound invitation.

Routing and target selection happen before this handoff. From this point the coupling is the sole owner of the invitation, ringing state and dialing state, including their media sessions and cancellation obligations.

pub fn state(&self) -> &CouplingState

The shared offer/answer and lifecycle policy while either leg remains early.

pub async fn confirmed(self) -> Result<ConfirmedCoupling>

Drive both early legs until they confirm, are cancelled, or receive a final refusal.

A matching inbound CANCEL withdraws the pending outbound INVITE. If its 2xx crossed the CANCEL, that now-confirmed outbound call receives BYE instead. An outbound 4xx/5xx is sent as the inbound INVITE’s final response with the same status and reason.

Trait Implementations

impl Debug for EarlyCoupling

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

Formats the value using the given formatter.