Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Stewart-DevTeam-Team/stewart_prealpha/llms.txt

Use this file to discover all available pages before exploring further.

El sistema de música de Stewart está centralizado en el singleton MusicManager, un AudioStreamPlayer global que carga las pistas desde un recurso Playlist y expone dos métodos públicos para controlar la reproducción. Al ser un autoload, puede llamarse desde cualquier parte del proyecto sin referencia directa al nodo.

​
Configuración

MusicManager extiende AudioStreamPlayer y se registra como autoload en el proyecto. Al iniciarse, carga la playlist de música desde el recurso res://autoload/resources/playlist.tres y valida que todos los ítems sean del tipo correcto.
music_manager.gd
extends AudioStreamPlayer

var _playlist: Playlist = load("uid://bc3risb100107")

func _ready():
    _playlist.expected_type = TYPE_OBJECT
    _playlist.check_item_types()

​
Métodos públicos

​
play_music(music_name: String) -> void

Obtiene la pista con el nombre music_name de la playlist y la reproduce inmediatamente. 
func play_music(music_name: String) -> void:
    stream = _playlist.get_item(music_name)
    play()
ParámetroTipoDescripción
music_nameStringNombre de la pista registrada en playlist.tres

​
switch_music_playing(on = null) -> void

Pausa o reanuda la música. Si on es null, alterna el estado actual. Si se pasa true o false, fuerza el estado indicado. 
func switch_music_playing(on = null) -> void:
    if on == null:
        stream_paused = not stream_paused
        return
    if not (on is bool):
        push_error("Tipo de dato incorrecto en MusicManager. Se espera un valor booleano")
    stream_paused = on
    return
ParámetroTipoDescripción
onbool | nulltrue pausa, false reanuda, null alterna
Pasar un valor que no sea bool ni null a switch_music_playing imprime un error en consola mediante push_error y no tiene efecto sobre la reproducción. Usa siempre un literal booleano o null.

​
Playlist de recursos

Las pistas de música se registran en res://autoload/resources/playlist.tres, un recurso de tipo Playlist editable desde el inspector de Godot. Cada ítem del recurso tiene un nombre clave (String) que se usa al llamar a play_music.
Para ver las pistas disponibles, abre playlist.tres en el inspector de Godot. El nombre de cada entrada es el valor que debes pasar a play_music.

​
Ejemplos de uso

llamar desde otro script
# Reproducir una pista por nombre
MusicManager.play_music("tema_principal")

# Pausar la música
MusicManager.switch_music_playing(true)

# Reanudar la música
MusicManager.switch_music_playing(false)

# Alternar entre pausado y en reproducción
MusicManager.switch_music_playing()

Build docs developers (and LLMs) love

Get started for freeTalk to us