Voice

VoiceManager manages voice connections per guild. Accessible via client.voice. FluxerVoiceConnection is returned on join and used for audio playback.

VoiceManager

`join`

pub async fn join(&self, guild_id: &str, channel_id: &str) -> Result<Arc<FluxerVoiceConnection>, VoiceError>

Connects to a voice channel. Sends opcode 4 to the Gateway, waits for VOICE_SERVER_UPDATE, then establishes a LiveKit WebRTC connection. If a live connection for the given channel_id already exists, returns it immediately without reconnecting.

Example

let conn = client.voice.join(&guild_id, &channel_id).await?;
conn.play_file("audio/track.mp3").await?;

`disconnect`

pub async fn disconnect(&self, channel_id: &str) -> Result<(), VoiceError>

Closes the connection for the given channel_id and sends opcode 4 with channel_id: null to notify the Gateway.

`disconnect_guild`

pub async fn disconnect_guild(&self, guild_id: &str) -> Result<(), VoiceError>

Disconnects all active connections belonging to a guild.

`disconnect_all`

pub async fn disconnect_all(&self)

Disconnects every active voice connection. Errors are silently ignored.

`stop_guild`

pub async fn stop_guild(&self, guild_id: &str)

Stops audio playback on all connections in the guild without closing the WebRTC connection.

`get_connection`

pub fn get_connection(&self, channel_id: &str) -> Option<Arc<FluxerVoiceConnection>>

Returns the active connection for a channel, or None if not connected.

`is_connected`

pub fn is_connected(&self, channel_id: &str) -> bool

Returns true if a live connection exists for the given channel_id.

FluxerVoiceConnection

Fields

Field	Type	Description
`guild_id`	`String`	Guild the connection belongs to.
`channel_id`	`String`	Voice channel the connection is bound to.
`connection_id`	`String`	Connection ID from the voice server response.

`play_file`

pub async fn play_file(&self, path: &str) -> Result<(), VoiceError>

Decodes and streams an audio file. Uses symphonia for decoding. The format is detected automatically from the file extension. Publishes an audio track on the first call if not already published.

Example

let conn = client.voice.join(&guild_id, &channel_id).await?;
conn.play_file("sounds/music.mp3").await?;

Supported formats

Format	Extension	✓ / ✗
MP3	`.mp3`	✓
OGG Vorbis	`.ogg`	✓
FLAC	`.flac`	✓
WAV / PCM	`.wav`	✓
AAC	`.aac`	✓
ALAC	`.m4a` (lossless)	✓
MP4 / M4A	`.mp4`, `.m4a`	✓
ADPCM	`.wav` (adpcm)	✓
Opus	`.opus`	✗
WMA	`.wma`	✗
AC-3 / EAC-3	`.ac3`	✗

`play_bytes`

pub async fn play_bytes(&self, data: Vec<u8>) -> Result<(), VoiceError>

Decodes and streams audio from a byte buffer. Same decoding pipeline as play_file — data must be a valid encoded audio file (MP3, OGG, WAV, etc.), not raw PCM samples.

Example

let bytes = tokio::fs::read("sounds/effect.ogg").await?;
conn.play_bytes(bytes).await?;

`stop`

pub async fn stop(&self) -> Result<(), VoiceError>

Stops the current playback. Does not close the connection — you can call play_file or play_bytes again afterwards.

`disconnect`

pub async fn disconnect(&self) -> Result<(), VoiceError>

Stops playback and closes the LiveKit room. After this the connection is no longer usable.

`is_connected`

pub fn is_connected(&self) -> bool

Returns true if the LiveKit room state is Connected.

VoiceError

Variant	Description
`Timeout`	Gateway did not send `VOICE_SERVER_UPDATE` within 60 seconds.
`ConnectionFailed(String)`	Failed to parse the voice server response or establish the connection.
`GatewayUnavailable`	`VoiceManager` has no gateway sender — client is not ready.
`NotConnected`	Operation requires an active connection, but none exists.
`PlaybackError(String)`	Error during audio streaming or task execution.
`LiveKit(String)`	Underlying LiveKit / WebRTC error.

Getting Started

Client

Structures

Builders

Networking

Utilities

VoiceManager

`join`

`disconnect`

`disconnect_guild`

`disconnect_all`

`stop_guild`

`get_connection`

`is_connected`

FluxerVoiceConnection

Fields

`play_file`

`play_bytes`

`stop`

`disconnect`

`is_connected`

VoiceError

​VoiceManager

​join

​disconnect

​disconnect_guild

​disconnect_all

​stop_guild

​get_connection

​is_connected

​FluxerVoiceConnection

​Fields

​play_file

​play_bytes

​stop

​disconnect

​is_connected

​VoiceError

VoiceManager

`join`

`disconnect`

`disconnect_guild`

`disconnect_all`

`stop_guild`

`get_connection`

`is_connected`

FluxerVoiceConnection

Fields

`play_file`

`play_bytes`

`stop`

`disconnect`

`is_connected`

VoiceError