SAAT - Audio API i zestaw narzędzi

Interfejs API audio i zarządzanie dźwiękiem dla SMAPI, bez wykorzystania HarmonyLib.
Dodaj własną muzykę do swoich modów!

Co robi ten mod?

SAAT to framework przeznaczony do dodawania, zarządzania i modyfikowania ścieżek audio w Stardew Valley. Ponadto, ma on na celu ulepszenie silnika audio w przyszłości, ponieważ silnik audio XNA/MonoGame jest słaby pod względem zarządzania pamięcią i obsługi. Jego celem jest brak harmonii.

Przykłady dodawania niestandardowych ścieżek audio można zobaczyć wDokumentacja na Github


Nowości w wersji 1.1.2:
- Naprawiono błąd powodujący wyświetlanie komunikatu ostrzegawczego „Nie można znaleźć CueDefinition o nazwie „title_day””

Nowości w wersji 1.1.1:
- Funkcja bezpieczeństwa zapobiegająca zawieszeniu się gry w przypadku nieprawidłowego wywołania lub nieznalezienia sygnału.
-- W przypadku błędu odtwarzany jest „domyślny sygnał”. Ten sygnał odtwarza ciszę.
- Możliwość wymuszonego dodania utworów audio do jukeboxa. Zobacz polecenie „addtojukebox”.
-- Dotyczy to migracji. W przypadku modyfikacji, które przeszły z Muzyki niestandardowej do SAAT, wszystkie utwory niestandardowe zostaną usunięte z playlisty w szafie grającej ze względu na wymagany prefiks (cm:) w notacji CM. SAAT weryfikuje wszystkie utwory w szafie grającej i usuwa te, których brakuje, aby zapobiec...

Nowości w wersji 1.1.0:
- Dodaj ustawienia ścieżki audio.
-- Można teraz ustawić wpis w pliku tracks.json tak, aby ciągle się powtarzał.
-- Można teraz ustawić wpis tak, aby automatycznie dodawał się do szafy grającej po utworzeniu nowej gry.
- Polecenie „setdebug” zmieniono na „audiodebug”, ponieważ istnieje duże prawdopodobieństwo wystąpienia konfliktu z innymi modami.
- Polecenie „gen_track_json” zostało przemianowane na „tracktemplate”.
- Polecenie „audio_allocs” zostało przemianowane na „audioallocs”.
- W poleceniu audioallocs wprowadzono kilka poprawek formatowania.
- Polecenie audioallocs ma teraz opcjonalny parametr. Dodanie identyfikatora utworu zapewni więcej szczegółów na temat konkretnego utworu.
- Przeprowadzono pewne zmiany wewnętrzne.
- Aktualizacja dokumentacji.

Obecna funkcjonalność:
Zezwól na dodanie zupełnie nowej muzyki i efektów dźwiękowych do Stardew Valley
Umożliwia dodawanie muzyki do szafy grającej.

Funkcje jeszcze nie zaimplementowane / nadchodzące:

Zastępowanie/nadpisywanie ścieżki audio
Użytkownik może zastąpić istniejące ścieżki audio innymi, nadpisując zasoby standardowe w sposób uniemożliwiający ich zniszczenie.

Przetwarzanie sygnału audio (APS lub DPS)

Nadchodząca funkcja umożliwi przetwarzanie dźwięku za pomocą filtrów dolnoprzepustowych i górnoprzepustowych, zmianę wysokości dźwięku, efektów i innych, bez konieczności tworzenia kolejnego utworu.

Prawidłowe zarządzanie pamięcią

To ma być główna funkcja API. Obecnie Stardew Valley opiera się na XNA/MonoGame do zarządzania pamięcią audio. Zarządzanie pamięcią jest źle zaprojektowane, ponieważ ładuje wszystko albo nic. Zazwyczaj dźwięk jest blokowany w pamięci, a nie przechowywany w całości na raz. Powoduje to bardzo duże zużycie pamięci.

Na przykład, zimowe utwory muzyczne są wczytywane do pamięci na początku gry. Nawet jeśli jest wiosna. Nie usłyszysz ścieżki dźwiękowej przez 3/4 gry, a mimo to nadal zajmuje ona pamięć.

Uwaga: Ten podzbiór API/Mod zostanie napisany w języku C. Aby zapewnić wydajność, wymagana jest wersja natywna.

Spakowany format audio

W połączeniu z odpowiednim zarządzaniem pamięcią, dźwięk ma być kompresowany do plików binarnych dla każdego modu. Pozwala to na szybsze ładowanie/rozładowywanie/przeładowywanie.

To będzienie będzie wymagane, ale zoptymalizuje wydajność, zwłaszcza w przypadku większych plików audio.

Zestaw narzędzi do formatu audio w formie spakowanej

Aby pomóc twórcom treści zoptymalizować dźwięk pod kątem wydajności i zachęcić ich do tego, udostępnimy narzędzie umożliwiające tworzenie spakowanego formatu audio, o którym mowa powyżej.

Kod źródłowy i dokumentacja