SAAT - Audio API and Toolkit

Audio API & Manajemen Audio untuk SMAPI, tanpa memanfaatkan HarmonyLib.
Tambahkan musik khusus ke mod Anda!

Apa fungsi mod ini?

SAAT adalah kerangka kerja yang bertujuan untuk menambah, mengelola, dan memodifikasi trek audio di Stardew Valley. Selain itu, SAAT juga bertujuan untuk meningkatkan mesin audio di kemudian hari, karena mesin audio XNA/MonoGame kurang optimal dalam hal manajemen dan dukungan memori. SAAT bertujuan untuk mengurangi harmoni.

Anda dapat melihat contoh cara menambahkan trek audio khusus dariDokumentasi di Github


Baru di v1.1.2:
- Memperbaiki bug yang menyebabkan pesan peringatan "Tidak dapat menemukan CueDefinition dengan nama 'title_day'"

Baru di v1.1.1:
- Fitur pengaman terhadap kegagalan untuk mencegah permainan mogok saat isyarat salah dipanggil/tidak ditemukan.
-- Jika gagal, "Isyarat Gagal" akan dimainkan. Isyarat ini akan memainkan keheningan.
- Kemampuan untuk menambahkan trek audio secara paksa ke jukebox. Lihat perintah "addtojukebox".
-- Ini untuk membahas migrasi. Mod yang bermigrasi dari Musik Kustom ke SAAT akan menghapus semua trek kustom dari daftar putar jukebox karena notasi awalan (cm:) yang diperlukan CM. SAAT memvalidasi semua trek di jukebox dan menghapus trek yang hilang untuk mencegahnya.

Baru di v1.1.0:
- Tambahkan Pengaturan Trek Audio.
-- Anda sekarang dapat mengatur entri di tracks.json untuk terus berulang.
-- Anda sekarang dapat mengatur entri untuk segera menambahkan dirinya ke jukebox saat permainan baru dibuat.
- Perintah "setdebug" telah diubah namanya menjadi "audiodebug", karena ada kemungkinan besar terjadi konflik dengan mod lain.
- Perintah "gen_track_json" telah diubah namanya menjadi "tracktemplate".
- Perintah "audio_allocs" telah diubah namanya menjadi "audioallocs".
- Perintah audioallocs telah mengalami beberapa perbaikan format.
Perintah audioallocs kini memiliki parameter opsional. Menambahkan ID trek akan memberikan detail lebih lanjut untuk trek tertentu.
- Beberapa restrukturisasi internal telah dilakukan.
- Pembaruan dokumentasi.

Fungsionalitas saat ini:
Izinkan musik dan efek suara baru ditambahkan ke Stardew Valley
Memungkinkan musik ditambahkan ke jukebox.

Belum Diimplementasikan / Fitur yang Akan Datang:

Penggantian / Penggantian Trek Audio
Seseorang dapat mengganti trek audio yang ada dengan yang lain, yang menggantikan aset vanilla dengan cara yang tidak dapat dirusak.

Pemrosesan Sinyal Audio (APS atau DPS)

Fitur mendatang yang akan memungkinkan audio mengalami low-pass, high-pass, perubahan nada, efek, dan lainnya tanpa perlu membuat trek lain.

Manajemen memori yang tepat

Ini akan menjadi fitur utama API. Saat ini, Stardew Valley mengandalkan XNA/MonoGame untuk menangani manajemen memori audio. Manajemen memori ini dirancang dengan buruk, karena memuat semua audio atau tidak sama sekali. Biasanya, audio dipecah-pecah ke dalam memori, alih-alih disimpan sekaligus. Hal ini menyebabkan konsumsi memori yang sangat besar.

Misalnya, trek musik musim dingin dimuat ke memori di awal permainan. Meskipun saat itu musim semi, Anda tidak akan mendengar trek audio selama 3/4 permainan, tetapi tetap saja menghabiskan memori.

Catatan: Subset API/Mod ini akan ditulis dalam bahasa C. Native diperlukan untuk memastikan kinerja.

Format Audio Paket

Dengan manajemen memori yang tepat, audio akan dipadatkan menjadi berkas biner per mod. Hal ini memungkinkan operasi pemuatan/pembongkaran/pemuatan ulang yang lebih cepat.

Itu akantidak diperlukan, tetapi akan mengoptimalkan kinerja. Terutama untuk file audio yang lebih besar.

Toolkit untuk Format Audio Paket

Untuk membantu dan mendorong pembuat konten dalam mengoptimalkan audio untuk performa, alat akan disediakan untuk membuat format audio paket yang disebutkan di atas.

Kode Sumber dan Dokumentasi