SAAT - API Audio e Toolkit

API audio e gestione audio per SMAPI, senza alcun utilizzo di HarmonyLib.
Aggiungi musica personalizzata alle tue mod!

Cosa fa questa mod?

SAAT è un framework progettato per aggiungere, gestire e modificare tracce audio in Stardew Valley. Inoltre, mira a migliorare il motore audio in futuro, poiché il motore audio di XNA/MonoGame è carente nella gestione e nel supporto della memoria. Il suo obiettivo è quello di essere privo di armonia.

Puoi vedere esempi di come aggiungere tracce audio personalizzate daDocumentazione su Github


Novità nella versione 1.1.2:
- Risolto un bug che causava la visualizzazione del messaggio di avviso "Impossibile trovare una CueDefinition con il nome 'title_day'"

Novità nella versione 1.1.1:
- Una funzione di sicurezza per impedire che il gioco si blocchi quando un segnale viene chiamato in modo errato/non viene trovato.
-- In caso di errore, viene riprodotto un "Segnale di errore". Questo segnale riproduce silenzio.
- Possibilità di aggiungere forzatamente tracce audio al jukebox. Vedi comando "addtojukebox".
-- Questo serve a coprire le migrazioni. I moderatori che sono passati da Musica personalizzata a SAAT vedranno tutte le tracce personalizzate rimosse dalla playlist del jukebox a causa della notazione del prefisso (cm:) richiesta da CM. SAAT convalida tutte le tracce nel jukebox e rimuove quelle mancanti per prevenire.

Novità nella versione 1.1.0:
- Aggiungi impostazioni traccia audio.
-- Ora è possibile impostare una voce in tracks.json in modo che venga ripetuta in modo continuo.
-- Ora puoi impostare una voce in modo che venga aggiunta immediatamente al jukebox quando viene creato un nuovo gioco.
- Il comando "setdebug" è stato rinominato in "audiodebug", poiché esiste un'alta probabilità di conflitto con altre mod.
- Il comando "gen_track_json" è stato rinominato in "tracktemplate".
- Il comando "audio_allocs" è stato rinominato in "audioallocs".
- Sono state apportate alcune correzioni di formattazione al comando audioallocs.
- Il comando audioallocs ora ha un parametro opzionale. L'aggiunta di un ID traccia fornirà ulteriori dettagli per una traccia specifica.
- È stata effettuata una ristrutturazione interna.
- Aggiornamento della documentazione.

Funzionalità attuale:
Consenti l'aggiunta di nuova musica ed effetti sonori in Stardew Valley
Permette di aggiungere musica al jukebox.

Funzionalità non ancora implementate / Prossime funzionalità:

Sostituzione/sostituzione delle tracce audio
Un individuo può sostituire le tracce audio esistenti con altre, sovrascrivendo le risorse originali in modo non distruttivo.

Elaborazione del segnale audio (APS o DPS)

Funzionalità in arrivo che consentirà di sottoporre l'audio a passaggi bassi, passaggi alti, alterazioni del tono, effetti e altro ancora, senza dover creare un'altra traccia.

Gestione corretta della memoria

Questa sarà la caratteristica principale dell'API. Al momento, Stardew Valley si affida a XNA/MonoGame per la gestione della memoria per l'audio. La gestione della memoria è mal progettata, in quanto carica tutto o niente. In genere, l'audio viene suddiviso in blocchi di memoria anziché essere distribuito in un'unica soluzione. Questo comporta un consumo di memoria molto elevato.

Ad esempio, le tracce musicali invernali vengono caricate in memoria all'inizio del gioco. Anche se è primavera, non sentirete la traccia audio per 3/4 del gioco, ma continua a consumare memoria.

Nota: questo sottoinsieme dell'API/Mod sarà scritto in C. Per garantire le prestazioni è necessario il linguaggio nativo.

Formato audio compresso

In combinazione con una corretta gestione della memoria, l'audio deve essere compattato in file binari per ogni mod. Questo consente operazioni di caricamento/scaricamento/ricaricamento più rapide.

Lo farànon essere richiesto, ma ottimizzerà le prestazioni, soprattutto per i file audio più grandi.

Toolkit per il formato audio compresso

Per aiutare e incoraggiare i creatori di contenuti a ottimizzare l'audio per le prestazioni, verrà fornito uno strumento per creare il formato audio compresso sopra menzionato.

Codice sorgente e documentazione