SAAT - Ses API ve Araç Kiti

HarmonyLib'i kullanmadan SMAPI için Ses API'si ve Ses Yönetimi.
Modlarınıza özel müzikler ekleyin!

Bu mod ne işe yarıyor?

SAAT, Stardew Valley'de ses parçaları eklemeyi, yönetmeyi ve düzenlemeyi amaçlayan bir çerçevedir. Ayrıca, XNA / MonoGame'in ses motoru bellek yönetimi ve desteği konusunda yetersiz kaldığı için, ilerleyen zamanlarda ses motorunu geliştirmeyi amaçlamaktadır. Uyumsuz olmayı hedeflemektedir.

Özel ses parçalarının nasıl ekleneceğine dair örnekleri şuradan görebilirsiniz:Github'daki belgeler


v1.1.2'deki yenilikler:
- "Başlık_günü" adında bir CueDefinition bulunamadı" uyarı mesajına neden olan bir hata düzeltildi

v1.1.1'deki yenilikler:
- İpucu yanlış çağrıldığında/bulunamadığı zaman oyunun çökmesini önlemek için bir güvenlik özelliği.
-- Başarısızlık durumunda "Varsayılan İşaret" çalınır. Bu işaret sessizliği çalar.
- Jukebox'a zorla ses parçaları ekleme yeteneği. "addtojukebox" komutuna bakın.
-- Bu, geçişleri kapsar. Custom Music'ten SAAT'a geçiş yapan modların, CM'nin gerektirdiği önek (cm:) notasyonu nedeniyle jukebox çalma listesinden tüm özel parçaları kaldırılacaktır. SAAT, jukebox'taki tüm parçaları doğrular ve eksik olanları kaldırarak eksik olanları engeller.

v1.1.0'daki yenilikler:
- Ses Parçası Ayarlarını ekleyin.
-- Artık tracks.json dosyasında sürekli döngüye girecek bir girdi ayarlayabilirsiniz.
-- Artık yeni bir oyun oluşturulduğunda bir girdinin kendisini hemen müzik kutusuna eklemesini sağlayabilirsiniz.
- "setdebug" komutu, diğer modlarla çakışma olasılığı yüksek olduğundan "audiodebug" olarak yeniden adlandırıldı.
- "gen_track_json" komutu "tracktemplate" olarak yeniden adlandırıldı.
- "audio_allocs" komutu "audioallocs" olarak yeniden adlandırıldı.
- Audioallocs komutunda bazı biçimlendirme düzeltmeleri yapıldı.
- audioallocs komutu artık isteğe bağlı bir parametreye sahip. Bir parça kimliği eklemek, belirli bir parça için daha fazla ayrıntı sağlayacaktır.
- İçeride bazı yeniden yapılanmalar yapıldı.
- Dokümantasyon güncellemesi.

Mevcut İşlevsellik:
Stardew Valley'e yepyeni müzik ve ses efektlerinin eklenmesine izin verin
Jukebox'a müzik eklenmesine olanak sağlar.

Henüz Uygulanmamış / Yakında Eklenecek Özellikler:

Ses Parçası Değiştirme / Geçersiz Kılma
Bir kişi, var olan ses parçalarını başkalarıyla değiştirebilir ve vanilya varlıklarını yok edilemez bir şekilde geçersiz kılabilir.

Ses Sinyali İşleme (APS veya DPS)

Başka bir parça oluşturmaya gerek kalmadan sesin düşük geçişli, yüksek geçişli, değiştirilmiş perdeli, efektli ve daha fazlasına tabi tutulmasına olanak sağlayacak yakında çıkacak özellik.

Uygun bellek yönetimi

Bu, API'nin temel özelliği olacak. Stardew Valley, şimdilik ses için bellek yönetimini XNA / MonoGame'e bağlıyor. Bellek yönetimi, ya hepsini ya da hiçbirini yüklemediği için tasarım açısından zayıf. Genellikle ses, hepsini aynı anda depolamak yerine belleğe bölünür. Bu da çok fazla bellek tüketimine neden olur.

Örneğin, kış müzikleri oyunun başında hafızaya yüklenir. İlkbahar olsa bile. Oyunun 3/4'ü boyunca müzik parçasını duymazsınız, ancak yine de hafızada yer kaplar.

Not: API/Mod'un bu alt kümesi C dilinde yazılacaktır. Performansı garantilemek için Native gereklidir.

Paketlenmiş Ses Formatı

Uygun bellek yönetimiyle birlikte, ses dosyaları mod başına ikili dosyalara sıkıştırılacaktır. Bu, daha hızlı yükleme/boşaltma/yeniden yükleme işlemlerine olanak tanır.

O olacakgerekli olmayabilir, ancak performansı optimize edecektir. Özellikle büyük ses dosyaları için.

Paketlenmiş Ses Formatı için Araç Seti

İçerik oluşturucularının performans için sesi optimize etmelerine yardımcı olmak ve onları teşvik etmek amacıyla, yukarıda belirtilen paketlenmiş ses formatını oluşturmak için bir araç sağlanacaktır.

Kaynak Kodu ve Belgeler