Métodos

📌 Tabla resumen

Método	Tipo	Descripción breve
Playlist()	Playlist	Crea una playlist vacía.
Playlist(Track[])	Playlist	Crea una playlist a partir de un array de Track en el orden indicado.
Playlist(string[])	Playlist	Crea una playlist a partir de un array de tags.
SetVolume(float)	Playlist	Define el volumen de la playlist antes de reproducirla.
SetHearDistance(float, float)	Playlist	Establece la distancia mínima y máxima a la que se oye la playlist.
SetVolumeRolloffCurve(VolumeRolloffCurve)	Playlist	Selecciona el tipo de atenuación del volumen con la distancia.
SetCustomVolumeRolloffCurve(AnimationCurve)	Playlist	Aplica una curva de atenuación personalizada.
ChangeVolume(float, float)	void	Cambia el volumen durante la reproducción (con lerp opcional).
SetPitch(float)	Playlist	Ajusta el pitch de todos los clips.
SetDopplerLevel(float)	Playlist	Define el nivel de efecto Doppler.
SetId(string)	Playlist	Asigna un identificador único a la playlist.
SetLoop(bool)	Playlist	Activa o desactiva la reproducción en bucle.
SetPlaylist(Track[])	Playlist	Sustituye la lista de reproducción por un array de Track.
SetPlaylist(string[])	Playlist	Sustituye la lista de reproducción por un array de tags.
AddToPlaylist(Track)	void	Añade un Track al final de la playlist en tiempo de ejecución.
AddToPlaylist(string)	void	Añade un tag de pista al final de la playlist en tiempo de ejecución.
Shuffle()	void	Baraja las pistas actuales y actualiza el orden de reproducción.
SetPosition(Vector3)	Playlist	Fija la posición 3D desde la que se emite el audio.
SetFollowTarget(Transform)	Playlist	Hace que la fuente de audio siga a un objeto de la escena.
SetSpatialSound(bool)	Playlist	Activa o desactiva el sonido espacial (3D).
SetFadeOut(float)	Playlist	Define el fade out que se aplicará al terminar cada pista o al detener la playlist.
SetFadeIn(float)	Playlist	Define el fade in que se aplicará al empezar cada pista o al iniciar la playlist.
SetOutput(Output)	Playlist	Envía el audio a una salida (AudioMixerGroup) concreta.
OnPlay(Action)	Playlist	Callback al iniciar la playlist.
OnComplete(Action)	Playlist	Callback al finalizar la playlist (o al detenerla manualmente).
OnLoopCycleComplete(Action)	Playlist	Callback al completar un ciclo de loop de la playlist.
OnNextTrackStart(Action)	Playlist	Callback al pasar a la siguiente pista de la playlist.
OnPause(Action)	Playlist	Callback al pausar la playlist.
OnPauseComplete(Action)	Playlist	Callback tras completar el fade out de la pausa.
OnResume(Action)	Playlist	Callback al reanudar la playlist después de una pausa.
Play()	void	Inicia la reproducción de la playlist.
Pause(float)	void	Pausa la playlist aplicando un fade out opcional.
Resume(float)	void	Reanuda la playlist con un fade in opcional.
Stop(float)	void	Detiene la playlist con un fade out opcional.

---

📘 Descripción detallada

Playlist Playlist()

Crea una instancia vacía; deberás añadir pistas antes de reproducir.

---

Playlist Playlist(Track[] playlistTracks)

Crea la playlist con los Track dados (en el orden proporcionado).

---

Playlist Playlist(string[] playlistTags)

Crea la playlist usando los tags dados (en el orden proporcionado).

---

Playlist SetVolume(float volume)

Establece el volumen inicial de toda la playlist (0 – 1).

---

Playlist SetHearDistance(float minHearDistance, float maxHearDistance)

Define la distancia en la que el audio se oye con máximo volumen y la distancia a la que empieza a oírse.

---

Playlist SetVolumeRolloffCurve(VolumeRolloffCurve curve)

Elige entre curva logarítmica o lineal para atenuar el volumen con la distancia.

---

Playlist SetCustomVolumeRolloffCurve(AnimationCurve curve)

Permite controlar con precisión la atenuación del volumen mediante una curva personalizada.

---

void ChangeVolume(float newVolume, float lerpTime)

Cambia el volumen durante la reproducción; si lerpTime > 0, realiza una transición suave.

---

Playlist SetPitch(float pitch)

Aplica un pitch fijo a todas las pistas de la playlist.

---

Playlist SetDopplerLevel(float dopplerLevel)

Ajusta la intensidad del efecto Doppler (0 – 5).

---

Playlist SetId(string id)

Asigna un identificador único a esta instancia para gestionarla mediante el SoundsGoodManager sin necesidad de una referencia directa.

---

Playlist SetLoop(bool loop)

Activa la repetición infinita de la lista de reproducción.

---

Playlist SetPlaylist(Track[] playlistTracks)

Sustituye la playlist actual por un array de Track.

---

Playlist SetPlaylist(string[] playlistTags)

Sustituye la playlist actual por un array de tags.

---

void AddToPlaylist(Track addedTrack)

Añade dinámicamente un Track al final de la cola de reproducción.

---

void AddToPlaylist(string addedTrackTag)

Añade dinámicamente un clip identificado por tag al final de la cola.

---

void Shuffle()

Baraja el orden de los clips actuales y actualiza la reproducción si la lista ya estaba sonando.

---

Playlist SetPosition(Vector3 position)

Fija la posición en el mundo desde donde se emitirá la playlist.

---

Playlist SetFollowTarget(Transform followTarget)

Hace que la fuente de audio siga en tiempo real a un objeto de la escena.

---

Playlist SetSpatialSound(bool activate)

Activa (true) o desactiva (false) el audio 3D espacial.

---

Playlist SetFadeOut(float fadeOutTime)

Define la duración del fade out para cada pista o al detener la playlist.

---

Playlist SetFadeIn(float fadeInTime)

Define la duración del fade in al comenzar cada pista o al iniciar la playlist.

---

Playlist SetOutput(Output output)

Envía la playlist a una salida (canal) concreta gestionada por un AudioMixerGroup.

---

Playlist OnPlay(Action onPlay)

Callback que se ejecuta cuando comienza la playlist.

---

Playlist OnComplete(Action onComplete)

Callback que se ejecuta cuando la playlist termina o se detiene manualmente.

---

Playlist OnLoopCycleComplete(Action onLoopCycleComplete)

Se dispara al completar un ciclo de loop si el bucle está activo.

---

Playlist OnNextTrackStart(Action onNextTrackStart)

Se ejecuta al finalizar la pista actual y comenzar la siguiente.

---

Playlist OnPause(Action onPause)

Se ejecuta inmediatamente al pausar la playlist.

---

Playlist OnPauseComplete(Action onPauseComplete)

Se dispara tras finalizar el fade out de la pausa.

---

Playlist OnResume(Action onResume)

Se ejecuta al reanudar la reproducción después de una pausa.

---

void Play()

Comienza la reproducción de la playlist aplicando el fade in configurado (si lo hay).

---

void Pause(float fadeOutTime)

Pausa la playlist; si se indica fadeOutTime, reduce el volumen gradualmente antes de pausar.

---

void Resume(float fadeInTime)

Reanuda la playlist desde la pausa; si se indica fadeInTime, aumenta el volumen progresivamente.

---

void Stop(float fadeOutTime)

Detiene la playlist y aplica el fade out dado; si omites el parámetro, detiene inmediatamente.

---