SAAT - API et Kit d'outils audio

API audio et gestion audio pour SMAPI, sans aucune utilisation de HarmonyLib.
Ajoutez de la musique personnalisée à vos mods !

Que fait ce mod ?

SAAT est un framework permettant d'ajouter, de gérer et de modifier des pistes audio dans Stardew Valley. Il vise également à améliorer le moteur audio ultérieurement, car celui de XNA/MonoGame est peu performant en termes de gestion et de prise en charge de la mémoire. Il vise à être dépourvu d'harmonie.

Vous pouvez voir des exemples sur la façon d'ajouter des pistes audio personnalisées à partir duDocumentation sur Github


Nouveautés de la v1.1.2 :
- Correction d'un bug qui entraînait le message d'avertissement « Impossible de trouver une CueDefinition avec le nom 'title_day' »

Nouveautés de la v1.1.1 :
- Une fonction de sécurité intégrée pour empêcher le jeu de planter lorsqu'un signal est appelé de manière incorrecte / introuvable.
En cas d'échec, un signal de défaut est émis. Ce signal est silencieux.
- Possibilité d'ajouter de force des pistes audio au jukebox. Voir la commande « addtojukebox ».
-- Ceci concerne les migrations. Les mods ayant migré de Custom Music vers SAAT verront tous les morceaux personnalisés supprimés de la playlist du jukebox en raison de la notation CM (préfixe cm:). SAAT valide tous les morceaux du jukebox et supprime ceux manquants pour éviter toute erreur.

Nouveautés de la v1.1.0 :
- Ajouter des paramètres de piste audio.
-- Vous pouvez désormais définir une entrée dans tracks.json pour qu'elle s'exécute en boucle en continu.
-- Vous pouvez désormais définir une entrée pour qu'elle s'ajoute immédiatement au jukebox lorsqu'un nouveau jeu est créé.
- La commande « setdebug » a été renommée en « audiodebug », car il existe une forte possibilité de conflit avec d'autres mods.
- La commande "gen_track_json" a été renommée en "tracktemplate".
- La commande "audio_allocs" a été renommée en "audioallocs".
- La commande audioallocs a bénéficié de quelques corrections de formatage.
- La commande audioallocs dispose désormais d'un paramètre facultatif. L'ajout d'un identifiant de piste fournira des détails supplémentaires sur une piste spécifique.
- Une certaine restructuration interne a été effectuée.
- Mise à jour de la documentation.

Fonctionnalité actuelle :
Autoriser l'ajout de nouvelles musiques et effets sonores dans Stardew Valley
Permet d'ajouter de la musique dans le jukebox.

Pas encore implémenté / Fonctionnalités à venir :

Remplacement/remplacement de piste audio
Un individu peut remplacer les pistes audio existantes par d'autres, remplaçant ainsi les ressources vanilla de manière non destructible.

Traitement du signal audio (APS ou DPS)

Fonctionnalité à venir qui permettra à l'audio de subir des effets passe-bas, passe-haut, hauteur modifiée, effets et plus encore sans avoir besoin de créer une autre piste.

Gestion appropriée de la mémoire

Il s'agit de la fonctionnalité principale de l'API. Actuellement, Stardew Valley s'appuie sur XNA / MonoGame pour gérer la mémoire audio. Cette gestion est mal conçue, car elle charge tout ou rien. Généralement, l'audio est fragmenté en mémoire plutôt que stocké en une seule fois, ce qui engendre une consommation de mémoire très importante.

Par exemple, les pistes musicales d'hiver sont chargées en mémoire au début du jeu. Même si c'est le printemps, vous n'entendrez pas la piste audio pendant les trois quarts du jeu, mais elle consomme quand même de la mémoire.

Remarque : ce sous-ensemble de l'API/Mod sera écrit en C. Le natif est requis pour garantir les performances.

Format audio compressé

En conjonction avec une gestion adéquate de la mémoire, l'audio doit être compacté en fichiers binaires pour chaque mod. Cela permet des opérations de chargement/déchargement/rechargement plus rapides.

Ce serane pas être requis, mais cela optimisera les performances, notamment pour les fichiers audio volumineux.

Boîte à outils pour le format audio compressé

Pour aider et encourager les créateurs de contenu à optimiser l'audio pour la performance, un outil sera fourni pour créer le format audio compressé mentionné ci-dessus.

Code source et documentation