AutoPlayUtils

Table of Contents

• Class Definition
• Methods

Class Definition

export abstract class AutoPlayUtils {}

info

AutoPlayUtils is an abstract utility class. All members are static — it cannot be instantiated directly.

Methods

buildTracksFromResponse()

static buildTracksFromResponse<T>(recommendedResult: LavalinkResponse, requester?: T): Track[]

Converts a raw LavalinkResponse into an array of Track objects, with isAutoplay set to true on each. Handles all load types.

Parameters

Parameter	Type	Description	Optional
recommendedResult	LavalinkResponse	The raw response from Lavalink.
requester	T	The user to set as the requester on each built track.

Returns

Type	Description
Track[]	The built tracks with isAutoplay: true.

---

getRecommendedTracks()

static async getRecommendedTracks(track: Track): Promise<Track[]>

Returns recommended tracks for the given track. Uses Last.fm if a lastFmApiKey is configured on the manager; otherwise iterates through autoPlaySearchPlatforms in priority order, querying each enabled source until results are found.

Parameters

Parameter	Type	Description	Optional
track	Track	The currently playing track to base recommendations on.

Returns

Type	Description
Promise<Track[]>	Recommended tracks, or an empty array if none could be found.

---

getRecommendedTracksFromLastFm()

static async getRecommendedTracksFromLastFm(track: Track, apiKey: string): Promise<Track[]>

Fetches recommended tracks via the Last.fm API using track.getSimilar. Falls back to artist.getTopTracks if no similar tracks are returned.

Parameters

Parameter	Type	Description	Optional
track	Track	The track to find similar tracks for.
apiKey	string	The Last.fm API key.

Returns

Type	Description
Promise<Track[]>	Recommended tracks, or an empty array if the request fails.

---

getRecommendedTracksFromSource()

static async getRecommendedTracksFromSource(track: Track, platform: AutoPlayPlatform): Promise<Track[]>

Fetches recommended tracks from the specified platform using its native recommendation API (e.g. sprec:, dzrec:, YouTube mix playlists, SoundCloud recommended page). If the track URI does not belong to the target platform, it is first resolved via a search query.

Parameters

Parameter	Type	Description	Optional
track	Track	The track to base recommendations on.
platform	AutoPlayPlatform	The platform to fetch recommendations from.

Returns

Type	Description
Promise<Track[]>	Recommended tracks, or an empty array if the platform is unsupported or the request fails.

---

init()

static async init(manager: Manager): Promise<void>

Initializes the static Manager reference used by AutoPlayUtils. Called internally by the manager.

Parameters

Parameter	Type	Description	Optional
manager	Manager	The Manager instance.