SAAT-音訊API和工具包

SMAPI 的音訊 API 和音訊管理，無需使用 HarmonyLib。
為您的模組添加自訂音樂！

這個模組有什麼作用？

SAAT 是一個用於在《星露穀物語》中添加、管理和修改音軌的框架。此外，由於 XNA/MonoGame 的音訊引擎在記憶體管理和支援方面表現不佳，SAAT 計劃在未來改進其音訊引擎。 SAAT 的目標是消除和聲。

您可以從Github 上的文檔


v1.1.2 中的新功能：
- 修正了導致警告訊息「無法找到名為『title_day』的 CueDefinition」的錯誤

v1.1.1 中的新功能：
- 故障安全功能可防止在錯誤呼叫/未找到提示時遊戲崩潰。
-- 失敗時，會播放「Defaulting Cue」（預設為提示）。此提示播放靜音。
- 強制將音軌加入點唱機的功能。請參閱“addtojukebox”命令。
-- 這是為了涵蓋遷移。由於需要前綴 (cm:) 符號 CM，從自訂音樂遷移到 SAAT 的模組的所有自訂曲目將從點唱機播放清單中移除。 SAAT 會驗證點唱機中的所有曲目，並移除缺少的曲目，以防止問題發生。

v1.1.0 中的新功能：
- 新增音軌設定。
-- 您現在可以在 tracks.json 中設定一個條目來連續循環。
-- 現在您可以設定一個條目，當創建新遊戲時立即將其新增至點唱機。
- 指令“setdebug”已重新命名為“audiodebug”，因為很有可能與其他模組發生衝突。
- 指令「gen_track_json」已重新命名為「tracktemplate」。
- 指令「audio_allocs」已重新命名為「audioallocs」。
- audioallocs 命令已進行一些格式修復。
- audioallocs 指令現在包含一個可選參數。添加軌道 ID 將提供特定軌道的更多詳細資訊。
- 進行了一些內部重組。
- 文檔更新。

目前功能：
允許將全新的音樂和音效添加到星露谷
允許將音樂加入點唱機。

尚未實現/即將推出的功能：

音軌替換/覆蓋
個人可以用另一個音軌替換現有的音軌，以不可破壞的方式覆蓋原始資產。

音訊訊號處理（APS或DPS）

即將推出的功能將允許音訊進行低通、高通、改變音調、效果等，而無需創建另一個音軌。

適當的記憶體管理

這將成為 API 的主要功能。目前，《星露穀物語》依賴 XNA/MonoGame 來處理音訊的記憶體管理。這種記憶體管理設計不佳，要么全部加載，要么全部不加載。通常情況下，音訊會被分塊載入到記憶體中，而不是一次載入所有音訊。這會導致記憶體消耗非常大。

例如，冬季音樂曲目在遊戲開始時就會載入到記憶體中。即使是春天，在遊戲進行到四分之三的時候你都聽不到這段音軌，但它仍然在消耗記憶體。

注意：此 API / Mod 子集將以 C 編寫。需要 Native 以確保效能。

打包音訊格式

結合適當的記憶體管理，音訊將按模組壓縮為二進位。這將加快加載/卸載/重新加載的速度。

它將不需要，但它會優化性能。特別是對於較大的音訊檔案。

打包音訊格式工具包

為了協助和鼓勵內容創作者優化音訊效能，將提供一個工具來創建上述打包音訊格式。

原始碼和文檔