Struct RiftHandle 

pub struct RiftHandle { /* private fields */ }

Primary SDK handle exposed to callers.

Implementations

impl RiftHandle

pub async fn new(config: RiftConfig) -> Result<Self, RiftError>

Initialize the SDK runtime with the given config and identity.

pub async fn set_dht_enabled(&self, enabled: bool)

Enable or disable DHT discovery for subsequent joins.

pub async fn set_bootstrap_nodes(&self, nodes: Vec<String>)

Override DHT bootstrap nodes.

pub async fn set_invite(&self, invite: Option<String>)

Provide an invite link override for joining.

pub async fn set_turn_servers(&self, servers: Vec<String>)

Configure TURN servers for relay fallback.

pub async fn set_audio_quality(&self, quality: Option<String>)

Override the audio quality preset.

pub async fn join_channel( &self, name: &str, password: Option<&str>, internet: bool, ) -> Result<(), RiftError>

Join a channel by name/password, optionally using internet mode.

pub async fn leave_channel(&self, _name: &str) -> Result<(), RiftError>

Leave the currently joined channel and tear down runtime state.

pub async fn send_chat(&self, text: &str) -> Result<(), RiftError>

Send a chat message to all peers.

pub async fn start_call(&self, peer: PeerId) -> Result<SessionId, RiftError>

Start a call with a specific peer.

pub async fn start_call_with_srt( &self, peer: PeerId, rndzv_srt_uri: Option<String>, ) -> Result<SessionId, RiftError>

Start a call with an optional rndzv SRT URI attached to the invite.

pub async fn accept_call(&self, session: SessionId) -> Result<(), RiftError>

Accept an incoming call.

pub async fn decline_call( &self, session: SessionId, reason: Option<&str>, ) -> Result<(), RiftError>

Decline an incoming call with optional reason.

pub async fn end_call(&self, session: SessionId) -> Result<(), RiftError>

End an active call session.

pub async fn next_event(&self) -> Option<RiftEvent>

Await the next event from the SDK.

pub fn try_next_event(&self) -> Option<RiftEvent>

Try to fetch the next event without awaiting.

pub fn set_ptt_active(&self, active: bool)

Set push-to-talk active state.

pub fn set_mute(&self, muted: bool)

Mute or unmute microphone capture.

pub fn local_peer_id(&self) -> PeerId

Return the local peer id.