Source code for mini_arcade_core.runtime.audio.audio_port

"""
Service interfaces for runtime components.
"""

from __future__ import annotations




class AudioPort:
    """Interface for audio playback operations."""



    def load_sound(self, sound_id: str, file_path: str):
        """
        Load a sound from a file and associate it with an identifier.

        :param sound_id: Identifier to associate with the sound.
        :type sound_id: str

        :param file_path: Path to the sound file.
        :type file_path: str
        """




    def play(self, sound_id: str, loops: int = 0):
        """
        Play the specified sound.

        :param sound_id: Identifier of the sound to play.
        :type sound_id: str

        :param loops: Number of times to loop the sound.
            0 = play once, -1 = infinite loop, 1 = play twice, etc.
        :type loops: int
        """