Vertex Docs

AudioManager.play_music(loops=0)

Description: Begins playback of the currently loaded music track. The music must be loaded first using AudioManager.load_music(). The optional loops parameter controls how many times the track will repeat after the initial playthrough, allowing for single-play tracks or continuously looping background music.

Usage

from VertexEngine.audio import AudioManager

AudioManager.load_music("assets/audio/theme.mp3")
AudioManager.play_music(loops=-1)

Parameters

• loops (int): Number of additional times the music should repeat after the first playback. Use 0 to play once, or -1 to loop indefinitely.

Returns

None — This method starts music playback but does not return a value.

Notes

• The music track must be loaded before calling this method.
• Only one music track can play at a time; calling this again will restart playback.
• Ideal for background music such as menus, levels, or ambient tracks.