SAAT - واجهة برمجة تطبيقات الصوت ومجموعة الأدوات

واجهة برمجة التطبيقات الصوتية وإدارة الصوت لـ SMAPI، دون أي استخدام لـ HarmonyLib.
أضف موسيقى مخصصة إلى تعديلاتك!

ماذا يفعل هذا التعديل؟

SAAT هو إطار عمل يهدف إلى إضافة وإدارة وتعديل مسارات الصوت في Stardew Valley. كما يهدف إلى تحسين محرك الصوت لاحقًا، نظرًا لضعف أداء محرك الصوت في XNA / MonoGame في إدارة الذاكرة ودعمها. يهدف إلى أن يكون خاليًا من التناغم.

يمكنك رؤية أمثلة حول كيفية إضافة مسارات صوتية مخصصة منالتوثيق على جيثب


جديد في الإصدار 1.1.2:
- تم إصلاح خطأ أدى إلى ظهور رسالة التحذير "لم يتم العثور على تعريف الإشارة باسم 'title_day'"

جديد في الإصدار 1.1.1:
- ميزة أمان الفشل لمنع تعطل اللعبة عند استدعاء إشارة بشكل غير صحيح / عدم العثور عليها.
عند الفشل، تُشغَّل إشارة "التقصير". هذه الإشارة تُشغِّل بصمت.
- إمكانية إضافة مسارات صوتية إلى جهاز الجوك بوكس. انظر أمر "addtojukebox".
هذا لتغطية عمليات النقل. ستُزال جميع المسارات المخصصة من قائمة تشغيل الجوك بوكس في التعديلات التي انتقلت من الموسيقى المخصصة إلى SAAT، وذلك بسبب استخدام بادئة (cm:) CM. يتحقق SAAT من صحة جميع المسارات في الجوك بوكس، ويزيل المسارات المفقودة لتجنب ذلك.

جديد في الإصدار 1.1.0:
- إضافة إعدادات المسار الصوتي.
-- يمكنك الآن تعيين إدخال في tracks.json للتكرار المستمر.
-- يمكنك الآن تعيين إدخال لإضافته فورًا إلى صندوق الموسيقى عند إنشاء لعبة جديدة.
- تمت إعادة تسمية الأمر "setdebug" إلى "audiodebug"، نظرًا لوجود احتمال كبير للتعارض مع التعديلات الأخرى.
- تمت إعادة تسمية الأمر "gen_track_json" إلى "tracktemplate".
- تمت إعادة تسمية الأمر "audio_allocs" إلى "audioallocs".
- تم إصلاح بعض مشاكل التنسيق الخاصة بأمر audioallocs.
أصبح لأمر audioallocs الآن مُعامل اختياري. إضافة مُعرِّف مسار سيُوفِّر تفاصيل إضافية لمسار مُحدَّد.
- تم إجراء بعض إعادة الهيكلة الداخلية.
- تحديث الوثائق.

الوظيفة الحالية:
السماح بإضافة موسيقى وتأثيرات صوتية جديدة إلى Stardew Valley
يسمح بإضافة الموسيقى إلى صندوق الموسيقى.

لم يتم تنفيذه بعد / الميزات القادمة:

استبدال المسار الصوتي / تجاوزاته
يمكن لأي فرد استبدال مسارات الصوت الموجودة بأخرى، وتجاوز الأصول الأصلية بطريقة غير قابلة للتدمير.

معالجة الإشارات الصوتية (APS أو DPS)

ميزة قادمة ستسمح للصوت بالخضوع لتمرير منخفض، وتمرير عالي، ودرجة صوتية متغيرة، وتأثيرات، والمزيد دون الحاجة إلى إنشاء مسار آخر.

إدارة الذاكرة بشكل صحيح

هذه هي الميزة الرئيسية لواجهة برمجة التطبيقات (API). حاليًا، تعتمد Stardew Valley على XNA/MonoGame لإدارة ذاكرة الصوت. إدارة الذاكرة سيئة التصميم، إذ تُحمّل كل شيء أو لا شيء. عادةً، يُجمّع الصوت في الذاكرة بدلًا من تخزينه دفعةً واحدة، مما يُؤدي إلى استهلاك كبير للذاكرة.

على سبيل المثال، تُحمّل مسارات موسيقى الشتاء إلى الذاكرة في بداية اللعبة. حتى لو كان فصل الربيع. لن تسمع المسار الصوتي لثلاثة أرباع اللعبة، ومع ذلك لا يزال يستهلك الذاكرة.

ملاحظة: سيتم كتابة هذه المجموعة الفرعية من API / Mod بلغة C. مطلوب Native لضمان الأداء.

تنسيق الصوت المعبأ

بالتزامن مع إدارة الذاكرة بشكل صحيح، يُضغط الصوت في ملفات ثنائية لكل تعديل. هذا يسمح بسرعة أكبر في التحميل والتفريغ وإعادة التحميل.

فإنه سوفلا يكون مطلوبا، ولكنه سيُحسّن الأداء، خاصةً لملفات الصوت الكبيرة.

مجموعة أدوات لتنسيق الصوت المزدحم

لمساعدة وتشجيع منشئي المحتوى على تحسين الصوت من أجل الأداء، سيتم توفير أداة لإنشاء تنسيق الصوت المعبأ المذكور أعلاه.

الكود المصدري والتوثيق