Vertex Docs

AudioManager.load_music(path)

Description: Loads a music track from disk into memory and registers it with the AudioManager. Once loaded, the music can be played, paused, stopped, or looped without needing to reload the file each time. This method is ideal for background music or long audio tracks that will be reused during gameplay.

Usage

from VertexEngine.audio import AudioManager

music = AudioManager.load_music("assets/audio/background.mp3")

Parameters

• path (str): The file path to the music file to load. Supported formats typically include .mp3, .wav, and .ogg, depending on the underlying audio backend.

Returns

Music object — An object representing the loaded music track. This object can be stored in a variable and used to control playback (play, pause, stop, set volume, loop, etc.).

Notes

• Calling this method multiple times with the same path may reuse cached data instead of reloading the file.
• For short sound effects, consider using AudioManager.load_sound() instead.
• Make sure the file path is valid; otherwise, an error may be raised.