SAAT - API y Toolkit de Audio

API de audio y gestión de audio para SMAPI, sin necesidad de utilizar HarmonyLib.
¡Agrega música personalizada a tus mods!

¿Qué hace este mod?

SAAT es un framework diseñado para añadir, gestionar y modificar pistas de audio en Stardew Valley. Además, busca mejorar el motor de audio más adelante, ya que el motor de audio de XNA/MonoGame presenta deficiencias en la gestión y el soporte de memoria. Su objetivo es no tener armonía.

Puede ver ejemplos de cómo agregar pistas de audio personalizadas desde elDocumentación en Github


Novedades en la versión v1.1.2:
- Se corrigió un error que generaba el mensaje de advertencia "No se pudo encontrar una CueDefinition con el nombre 'title_day' "

Novedades en la versión v1.1.1:
- Una función de seguridad para evitar que el juego se bloquee cuando se pide incorrectamente un taco o no se encuentra.
En caso de fallo, se reproduce una señal de incumplimiento. Esta señal reproduce silencio.
- La posibilidad de añadir pistas de audio a la gramola de forma forzada. Véase el comando "addtojukebox".
Esto cubre las migraciones. A los mods que migraron de Música Personalizada a SAAT se les eliminarán todas las pistas personalizadas de la lista de reproducción de la rocola debido al prefijo (cm:) requerido. SAAT valida todas las pistas en la rocola y elimina las que faltan para evitarlo.

Novedades en la versión v1.1.0:
- Agregar configuraciones de pista de audio.
-- Ahora puedes configurar una entrada en tracks.json para que se repita de forma continua.
-- Ahora puedes configurar una entrada para que se agregue inmediatamente a la rocola cuando se crea un juego nuevo.
- El comando "setdebug" ha sido renombrado a "audiodebug", ya que existe una gran posibilidad de conflicto con otros mods.
- El comando "gen_track_json" ha sido renombrado a "tracktemplate".
- El comando "audio_allocs" ha sido renombrado a "audioallocs".
- Se han realizado algunas correcciones de formato al comando audioallocs.
El comando audioallocs ahora tiene un parámetro opcional. Al agregar un ID de pista, se proporcionarán más detalles de una pista específica.
-Se realizó cierta reestructuración interna.
- Actualización de la documentación.

Funcionalidad actual:
Permite que se agreguen música y efectos de sonido nuevos a Stardew Valley
Permite agregar música a la rocola.

No implementado aún / Próximas funciones:

Reemplazo/Anulación de pistas de audio
Una persona puede reemplazar pistas de audio existentes con otras, anulando los recursos originales de manera no destructible.

Procesamiento de señales de audio (APS o DPS)

Próxima función que permitirá que el audio pase por paso bajo, paso alto, tono alterado, efectos y más sin la necesidad de crear otra pista.

Gestión adecuada de la memoria

Esta será la característica principal de la API. Actualmente, Stardew Valley utiliza XNA/MonoGame para gestionar la memoria de audio. Esta gestión de memoria tiene un diseño deficiente, ya que carga todo o nada. Normalmente, el audio se fragmenta en memoria en lugar de almacenarlo todo de una vez. Esto genera un consumo de memoria muy elevado.

Por ejemplo, las pistas de música de invierno se cargan en la memoria al principio del juego. Incluso en primavera. No se oye la pista de audio durante tres cuartos del juego, pero sigue consumiendo memoria.

Nota: Este subconjunto de la API/Mod se escribirá en C. Se requiere versión nativa para garantizar el rendimiento.

Formato de audio empaquetado

Junto con una gestión adecuada de la memoria, el audio se compacta en archivos binarios por módulo. Esto permite una carga, descarga y recarga más rápidas.

Va ano ser requeridoPero optimizará el rendimiento, especialmente para archivos de audio grandes.

Kit de herramientas para formatos de audio empaquetados

Para ayudar y alentar a los creadores de contenido a optimizar el audio para el rendimiento, se proporcionará una herramienta para crear el formato de audio empaquetado mencionado anteriormente.

Código fuente y documentación