AudioPlayer
export declare class AudioPlayer extends EventEmitter export declare class AudioPlayer extends EventEmitter Used to play audio resources (i.e. tracks, streams) to voice connections.
Remarks
Audio players are designed to be re-used - even if a resource has finished playing, the player itself can still be used.The AudioPlayer drives the timing of playback, and therefore is unaffected by voice connections becoming unavailable. Its behavior in these scenarios can be configured.Extends
EventEmitterconstructor(options?)
Creates a new AudioPlayer.
| Name | Type | Optional | Description |
|---|---|---|---|
| options | CreateAudioPlayerOptions | Yes | None |
Readonly
A list of subscribed voice connections that can currently receive audio to play.
The state that the player is in.
checkPlayable()
:
boolean
Checks whether the underlying resource (if any) is playable (readable)
pause(interpolateSilence?)
:
boolean
Pauses playback of the current resource, if any.
| Name | Type | Optional | Description |
|---|---|---|---|
| interpolateSilence | boolean | Yes | If true, the player will play 5 packets of silence after pausing to prevent audio glitches |
play(resource)
:
void
Plays a new resource on the player. If the player is already playing a resource, the existing resource is destroyed (it cannot be reused, even in another player) and is replaced with the new resource.
Remarks
The player will transition to the Playing state once playback begins, and will return to the Idle state once playback is ended.If the player was previously playing a resource and this method is called, the player will not transition to the Idle state during the swap over.| Name | Type | Optional | Description |
|---|---|---|---|
| resource | AudioResource<T> | No | The resource to play |
stop(force?)
:
boolean
Stops playback of the current resource and destroys the resource. The player will either transition to the Idle state, or remain in its current state until the silence padding frames of the resource have been played.
| Name | Type | Optional | Description |
|---|---|---|---|
| force | boolean | Yes | If true, will force the player to enter the Idle state even if the resource has silence padding frames |
unpause()
:
boolean
Unpauses playback of the current resource, if any.
on(event, listener)
:
this
Emitted when there is an error emitted from the audio resource played by the audio player
| Name | Type | Optional | Description |
|---|---|---|---|
| event | 'error' | No | None |
| listener | (error: AudioPlayerError) => void | No | None |