Struct songbird::driver::Driver

pub struct Driver { /* fields omitted */ }

The control object for a Discord voice connection, handling connection, mixing, encoding, en/decryption, and event generation.

When compiled with the "builtin-queue" feature, each driver includes a track queue as a convenience to prevent the additional overhead of per-guild state management.

Implementations

impl Driver

pub fn new(config: Config) -> Self

Creates a new voice driver.

This will create the core voice tasks in the background.

pub fn connect(&mut self, info: ConnectionInfo) -> Connect

Connects to a voice channel using the specified server.

This method instantly contacts the driver tasks, and its does not need to be awaited to start the actual connection.

pub fn leave(&mut self)

Leaves the current voice channel, disconnecting from it.

This does not forget settings, like whether to be self-deafened or self-muted.

pub fn mute(&mut self, mute: bool)

Sets whether the current connection is to be muted.

If there is no live voice connection, then this only acts as a settings update for future connections.

pub fn is_mute(&self) -> bool

Returns whether the driver is muted (i.e., processes audio internally but submits none).

pub fn play_source(&mut self, source: Input) -> TrackHandle

Plays audio from a source, returning a handle for further control.

This can be a source created via ffmpeg or ytdl.

pub fn play_only_source(&mut self, source: Input) -> TrackHandle

Plays audio from a source, returning a handle for further control.

Unlike play_source, this stops all other sources attached to the channel.

pub fn play(&mut self, track: Track)

Plays audio from a Track object.

This will be one half of the return value of create_player. The main difference between this function and play_source is that this allows for direct manipulation of the Track object before it is passed over to the voice and mixing contexts.

pub fn play_only(&mut self, track: Track)

Exclusively plays audio from a Track object.

This will be one half of the return value of create_player. As in play_only_source, this stops all other sources attached to the channel. Like play, however, this allows for direct manipulation of the Track object before it is passed over to the voice and mixing contexts.

pub fn set_bitrate(&mut self, bitrate: Bitrate)

Sets the bitrate for encoding Opus packets sent along the channel being managed.

The default rate is 128 kbps. Sensible values range between Bits(512) and Bits(512_000) bits per second. Alternatively, Auto and Max remain available.

pub fn stop(&mut self)

Stops playing audio from all sources, if any are set.

pub fn set_config(&mut self, config: Config)

Sets the configuration for this driver.

pub fn add_global_event<F: EventHandler + 'static>(
    &mut self,
    event: Event,
    action: F
)

Attach a global event handler to an audio context. Global events may receive any EventContext.

Global timing events will tick regardless of whether audio is playing, so long as the bot is connected to a voice channel, and have no tracks. TrackEvents will respond to all relevant tracks, giving some audio elements.

Users must ensure that no costly work or blocking occurs within the supplied function or closure. Taking excess time could prevent timely sending of packets, causing audio glitches and delays.

pub fn remove_all_global_events(&mut self)

Removes all global event handlers from an audio context.

impl Driver

pub fn queue(&self) -> &TrackQueue

Returns a reference to this driver’s built-in queue.

Requires the "builtin-queue" feature. Queue additions should be made via enqueue and enqueue_source.

pub fn enqueue_source(&mut self, source: Input)

Adds an audio Input to this driver’s built-in queue.

Requires the "builtin-queue" feature.

pub fn enqueue(&mut self, track: Track)

Adds an existing Track to this driver’s built-in queue.

Requires the "builtin-queue" feature.

Trait Implementations

impl Clone for Driver

fn clone(&self) -> Driver

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Driver

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

Formats the value using the given formatter.

impl Default for Driver

fn default() -> Self

Returns the “default value” for a type.

impl Drop for Driver

fn drop(&mut self)

Leaves the current connected voice channel, if connected to one, and forgets all configurations relevant to this Handler.