Class Queue

Represents a queue.

Hierarchy (view full)

DisTubeBase
- Queue

Constructors

constructor

new Queue(distube, voice, textChannel?): Queue
Create a queue for the guild
Parameters
- distube: DisTube
  DisTube
- voice: DisTubeVoice
  Voice connection
- OptionaltextChannel: GuildTextBasedChannel
  Default text channel
Returns Queue
Overrides DisTubeBase.constructor
- Defined in src/struct/Queue.ts:83

Properties

_beginTime

_beginTime: number

What time in the song to begin (in seconds).

`Optional`_listeners

_listeners?: DisTubeVoiceEvents

DisTubeVoice listener

_next

_next: boolean

Whether or not the last song was skipped to next song.

_prev

_prev: boolean

Whether or not the last song was skipped to previous song.

_taskQueue

_taskQueue: TaskQueue

Task queuing system

autoplay

autoplay: boolean

Whether or not the autoplay mode is enabled. Default value: false

distube

distube: DisTube

ffmpegArgs

ffmpegArgs: FFmpegArgs

FFmpeg arguments for the current queue. Default value is defined with DisTubeOptions.ffmpeg.args. af output argument will be replaced with Queue#filters manager

`Readonly`id

id: string

Queue id (Guild id)

paused

paused: boolean

Whether or not the stream is currently paused.

playing

playing: boolean

Whether or not the stream is currently playing.

previousSongs

previousSongs: Song<unknown>[]

List of the previous songs.

repeatMode

repeatMode: RepeatMode

Type of repeat mode (0 is disabled, 1 is repeating a song, 2 is repeating all the queue). Default value: 0 (disabled)

songs

songs: Song<unknown>[]

List of songs in the queue (The first one is the playing song)

stopped

stopped: boolean

Whether stream is currently stopped.

`Optional`textChannel

textChannel?: GuildTextBasedChannel

The text channel of the Queue. (Default: where the first command is called).

voice

voice: DisTubeVoice

Voice connection of this queue.

Accessors

client

get client(): Client<boolean>
Discord.js client

Returns Client<boolean>
Inherited from DisTubeBase.client
- Defined in src/core/DisTubeBase.ts:61

clientMember

get clientMember(): undefined | GuildMember
The client user as a GuildMember of this queue's guild

Returns undefined | GuildMember
- Defined in src/struct/Queue.ts:111

currentTime

get currentTime(): number
What time in the song is playing (in seconds).

Returns number
- Defined in src/struct/Queue.ts:135

duration

get duration(): number
Queue's duration.

Returns number
- Defined in src/struct/Queue.ts:129

filters

get filters(): FilterManager
The filter manager of the queue

Returns FilterManager
- Defined in src/struct/Queue.ts:117

formattedCurrentTime

get formattedCurrentTime(): string
Formatted Queue#currentTime string.

Returns string
- Defined in src/struct/Queue.ts:141

formattedDuration

get formattedDuration(): string
Formatted duration string.

Returns string
- Defined in src/struct/Queue.ts:123

handler

get handler(): DisTubeHandler
DisTube handler

Returns DisTubeHandler
Inherited from DisTubeBase.handler
- Defined in src/core/DisTubeBase.ts:73

options

get options(): Options
DisTube options

Returns Options
Inherited from DisTubeBase.options
- Defined in src/core/DisTubeBase.ts:67

plugins

get plugins(): DisTubePlugin[]
DisTube plugins

Returns DisTubePlugin[]
Inherited from DisTubeBase.plugins
- Defined in src/core/DisTubeBase.ts:79

queues

get queues(): QueueManager
The queue manager

Returns QueueManager
Inherited from DisTubeBase.queues
- Defined in src/core/DisTubeBase.ts:49

voiceChannel

get voiceChannel(): null | VoiceBasedChannel
The voice channel playing in.

Returns null | VoiceBasedChannel
- Defined in src/struct/Queue.ts:147

voices

get voices(): DisTubeVoiceManager
The voice manager

Returns DisTubeVoiceManager
Inherited from DisTubeBase.voices
- Defined in src/core/DisTubeBase.ts:55

volume

get volume(): number
Get or set the stream volume. Default value: 50.

Returns number
- Defined in src/struct/Queue.ts:153
set volume(value): void
Parameters
- value: number
Returns void
- Defined in src/struct/Queue.ts:156

Methods

addRelatedSong

addRelatedSong(): Promise<Song<unknown>>
Add a related song of the playing song to the queue

Returns Promise<Song<unknown>>
The added song
- Defined in src/struct/Queue.ts:370

addToQueue

addToQueue(song, position?): Queue
Parameters
- song: Song<unknown> | Song<unknown>[]
  Song to add
- position: number = 0
  Position to add, <= 0 to add to the end of the queue
Returns Queue
The guild queue

Throws
- Defined in src/struct/Queue.ts:165

debug

debug(message): void
Emit debug event
Parameters
- message: string
  debug message
Returns void
Inherited from DisTubeBase.debug
- Defined in src/core/DisTubeBase.ts:43

emit

emit(eventName, ...args): boolean
Emit the DisTube of this base
Parameters
- eventName: keyof DisTubeEvents
  Event name
- Rest...args: any
  arguments
Returns boolean
Inherited from DisTubeBase.emit
- Defined in src/core/DisTubeBase.ts:27

emitError

emitError(error, queue, song?): void
Emit error event
Parameters
- error: Error
  error
- queue: Queue
  The queue encountered the error
- Optionalsong: Song<unknown>
  The playing song when encountered the error
Returns void
Inherited from DisTubeBase.emitError
- Defined in src/core/DisTubeBase.ts:36

isPaused

isPaused(): boolean
Returns boolean
true if the queue is paused
- Defined in src/struct/Queue.ts:192

isPlaying

isPlaying(): boolean
Returns boolean
true if the queue is playing
- Defined in src/struct/Queue.ts:186

jump

jump(position): Promise<Song<unknown>>
Jump to the song position in the queue. The next one is 1, 2,... The previous one is -1, -2,... if num is invalid number
Parameters
- position: number
  The song position to play
Returns Promise<Song<unknown>>
The new Song will be played
- Defined in src/struct/Queue.ts:303

pause

pause(): Promise<Queue>
Pause the guild stream

Returns Promise<Queue>
The guild queue
- Defined in src/struct/Queue.ts:199

play

play(emitPlaySong?): Promise<void>
Play the first song in the queue
Parameters
- emitPlaySong: boolean = true
  Whether or not emit Events.PLAY_SONG event
Returns Promise<void>
- Defined in src/struct/Queue.ts:430

previous(): Promise<Song<unknown>>
Play the previous song if exists

Returns Promise<Song<unknown>>
The guild queue
- Defined in src/struct/Queue.ts:261

remove

remove(): void
Remove the queue from the manager

Returns void
- Defined in src/struct/Queue.ts:406

resume

resume(): Promise<Queue>
Resume the guild stream

Returns Promise<Queue>
The guild queue
- Defined in src/struct/Queue.ts:214

seek

seek(time): Queue
Set the playing time to another position
Parameters
- time: number
  Time in seconds
Returns Queue
The guild queue
- Defined in src/struct/Queue.ts:354

setRepeatMode

setRepeatMode(mode?): RepeatMode
Set the repeat mode of the guild queue. Toggle mode (Disabled -> Song -> Queue -> Disabled ->...) if mode is undefined
Parameters
- Optionalmode: RepeatMode
  The repeat modes (toggle if undefined)
Returns RepeatMode
The new repeat mode
- Defined in src/struct/Queue.ts:340

setVolume

setVolume(percent): Queue
Set the guild stream's volume
Parameters
- percent: number
  The percentage of volume you want to set
Returns Queue
The guild queue
- Defined in src/struct/Queue.ts:230

shuffle

shuffle(): Promise<Queue>
Shuffle the queue's songs

Returns Promise<Queue>
The guild queue
- Defined in src/struct/Queue.ts:281

skip

skip(): Promise<Song<unknown>>
Skip the playing song if there is a next song in the queue. If Queue#autoplay is true and there is no up next song, DisTube will add and play a related song.

Returns Promise<Song<unknown>>
The song will skip to
- Defined in src/struct/Queue.ts:241

stop

stop(): Promise<void>
Stop the guild stream and delete the queue

Returns Promise<void>
- Defined in src/struct/Queue.ts:391

toggleAutoplay

toggleAutoplay(): boolean
Toggle autoplay mode

Returns boolean
Autoplay mode state
- Defined in src/struct/Queue.ts:422

Class Queue

Hierarchy (view full)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns Queue

Properties

_beginTime

Optional_listeners

_next

_prev

_taskQueue

autoplay

distube

ffmpegArgs

Readonlyid

paused

playing

previousSongs

repeatMode

songs

stopped

OptionaltextChannel

voice

Accessors

client

Returns Client<boolean>

clientMember

Returns undefined | GuildMember

currentTime

Returns number

duration

Returns number

filters

Returns FilterManager

formattedCurrentTime

Returns string

formattedDuration

Returns string

handler

Returns DisTubeHandler

options

Returns Options

plugins

Returns DisTubePlugin[]

queues

Returns QueueManager

voiceChannel

Returns null | VoiceBasedChannel

voices

Returns DisTubeVoiceManager

volume

Returns number

Parameters

Returns void

Methods

addRelatedSong

Returns Promise<Song<unknown>>

addToQueue

Parameters

Returns Queue

Throws

debug

Parameters

Returns void

emit

Parameters

Returns boolean

emitError

Parameters

Returns void

isPaused

Returns boolean

isPlaying

Returns boolean

`Optional`_listeners

`Readonly`id

`Optional`textChannel