Options
All
  • Public
  • Public/Protected
  • All
Menu

The audio player class of discord-play.

Must be created only after a voice connection is established, either through a DisPlayConnection instance or the @discordjs/voice joinVoiceChannel function.

Hierarchy

Index

Constructors

constructor

  • Attaches logic to the audio player and binds it to the voice connection.

    throws

    Error if no active voice connection was found.

    Parameters

    • guildId: string

      The ID of the guild where the voice connection is established.

    Returns DisPlayPlayer

Properties

Readonly player

player: AudioPlayer = ...

The {@link AudioPlayer} instance from @discordjs/voice.

Private volumeCache

volumeCache: null | number = null

Stores volume amount before muting the player, which can be restored back when unmuting the player.

Static defaultMaxListeners

defaultMaxListeners: number

Accessors

volume

  • get volume(): undefined | number
  • Returns the amount of volume in percentage (0 to 100) of the player resource.

    remarks

    Returns percentage of volume else undefined if player doesn't have any underlying resource or resource doesn't have inline volume enabled (has 100% volume).

    Returns undefined | number

Methods

Private _isVolumeChangeable

  • _isVolumeChangeable(): boolean
  • To detect if currently underlying resource (if any) has inline volume enabled or not.

    Returns boolean

    true if inline volume is enabled, otherwise false.

addListener

  • Type parameters

    Parameters

    Returns DisPlayPlayer

emit

  • emit<U>(event: U, ...args: Parameters<PlayerEvents[U]>): boolean
  • Type parameters

    Parameters

    Returns boolean

eventNames

  • eventNames<U>(): U[]
  • Type parameters

    Returns U[]

getMaxListeners

  • getMaxListeners(): number
  • Returns number

listenerCount

  • Parameters

    Returns number

listeners

  • Type parameters

    Parameters

    • type: U

    Returns PlayerEvents[U][]

off

  • Type parameters

    Parameters

    Returns DisPlayPlayer

on

  • Type parameters

    Parameters

    Returns DisPlayPlayer

once

  • Type parameters

    Parameters

    Returns DisPlayPlayer

play

  • play(resource: AudioResource<unknown>): void
  • play(source: string | Readable, options?: PlayOptions): void
  • Plays the input audio resource, and any previously playing resource gets destroyed and replaced.

    Parameters

    • resource: AudioResource<unknown>

      The audio resouce.

    Returns void

  • Plays the input audio resource, and any previously playing resource gets destroyed and replaced.

    Parameters

    • source: string | Readable

      Can be either :

      • Audio url i.e. local file path or an online audio url (will require ffmpeg).
      • Readable stream of audio data.
    • Optional options: PlayOptions

    Returns void

prependListener

  • Type parameters

    Parameters

    Returns DisPlayPlayer

prependOnceListener

  • Type parameters

    Parameters

    Returns DisPlayPlayer

rawListeners

  • Type parameters

    Parameters

    • type: U

    Returns PlayerEvents[U][]

removeAllListeners

  • Parameters

    Returns DisPlayPlayer

removeListener

  • Type parameters

    Parameters

    Returns DisPlayPlayer

setMaxListeners

  • Parameters

    • n: number

    Returns DisPlayPlayer

setVolume

  • setVolume(volume: number): boolean
  • Changes volume of the underlying resource of the player.

    remarks

    Works only when inline volume of resource was enabled.

    Parameters

    • volume: number

      Percentage of volume to set (0 to 100).

    Returns boolean

    true if volume is changed successfully, otherwise false.

stop

  • stop(): boolean
  • Stops the audio player and destroys any underlying resource.

    Returns boolean

    true if the player will come to a stop, otherwise false.

toggleMute

  • toggleMute(): boolean
  • Mutes/Unmutes the audio player.

    remarks

    Requires the currently playing audio resource to have inline volume enabled.

    throws

    Error if resource doesn't have inline volume enabled.

    Returns boolean

    true if player was muted, otherwise false.

togglePause

  • togglePause(): boolean
  • Pauses/unpauses the audio player.

    Returns boolean

    true if player is paused, else false i.e. unpaused.

Generated using TypeDoc