loaforcsSoundAPI

Mod pengganti suara portabel, dibuat untuk memberi pembuat paket suara lebih banyak kontrol dan basis kode yang lebih dapat dipelihara.

Untuk pencipta paket suara

A Tutorial sederhana Untuk membuat paket suara tersedia di wiki github. Contoh. Tersedia juga.

• Hierarki struktur file kustom
• Pemetaan beberapa suara ke suara yang sama
• Paket suara dapat membuat opsi konfigurasi seperti mod biasa
• Tukarkan klip audio secara langsung berdasarkan apa yang terjadi dalam game.

Untuk pengembang

Soundapi pada akhirnya akan berisi beberapa utilitas untuk membantu memuat suara khusus. Semua metode penggunaan umum berada di bawah SoundAPI Kelas.

Kondisi khusus

Inilah contoh kondisi.

[soundapcondition("LethalCompany:apparatusstate ")] //atribut untuk SoundAPI.RegisterAll fungsi kelas publik apparatusstatecondition:Condition{public enum StateType {PULLED, PLUGGED_IN} internal statis bool currentapparatuspull=false; public StateType?Value {get; internal set;} public override bool Evaluate (konteks icontext) {StateType state=currentapparatuspull?statetype.pull:StateType.PLUGGED_IN; return state ==(Value??statetype.pull);}}// untuk mendaftarkan semua di rakitan Anda (ini akan menghormati dependensi lunak lainnya di mod Anda) SoundAPI.RegisterAll(Assembly.GetExecutingAssembly ()); //atau secara manual (jika Anda memerlukan logika yang lebih kompleks) SoundAPI.RegisterCondition("LethalLevelLoader:dungeon:has_tag ", () = > new lltagcondition<ExtendedDungeonFlow>(() = > {if (! RoundManager.Instance) mengembalikan nol; if (! RoundManager.Instance.dungeonggenerator) mengembalikan nol; if (! PatchedContent.TryGetExtendedContent(RoundManager.Instance.dungeonGenerator.Generator.DungeonFlow, out extendedungeonflow lldungeon)) mengembalikan nol; mengembalikan lldungeon;}));

Akan digunakan oleh pembuat paket suara

{"kondisi ": {"tipe": "LethalCompany:apparat_state"}}

Karena. Nilai. Dapat dibatalkan, pembuat paket suara tidak perlu memberikan nilai, dan secara default akan menjadi true. Jika tidak, mereka dapat mengaturnya secara manual ke Dimasukkan ke dalam Untuk memeriksa apakah perangkat telah dicolokkan. Disarankan untuk menggunakan enum meskipun saat ini hanya ada dua opsi untuk kompatibilitas maju.

Pemetaan

Pemetaan adalah untuk pengembang mod untuk menulis pintasan ke satu atau lebih pencocokan suara. Disarankan pembuat paket suara menggunakan pemetaan jika memungkinkan untuk kompatibilitas maju (karena pengembang mod dapat memperbarui file pemetaan dengan pembaruan mod, tanpa paket suara perlu diperbarui.)

Untuk menggunakan pemetaan Anda perlu menyertakan a Soundpack.json Di zip mod Anda (ini soundapi memuatnya secara otomatis, opsi untuk memuatnya melalui SoundAPI Kelas mungkin datang nanti). Anda tidak perlu memasukkan a Pengganti Atau. Suara suara folder. A. File kemudian masuk ke folder yang sama.

Contoh. file:

{"FacilityMeltdown:music ": [" MeltdownHandler: meltdownMusic: meltdownMusic "]," FacilityMeltdown:warning_voice ": [" MeltdownHandler: WarningVoice: warning1 "," MeltdownHandler: WarningVoice: warning2 "," MeltdownHandler: WarningVoice: warning3 "," MeltdownHandler: WarningVoice: warning4 "]}

Catatan: yang soundapi_mappings.json Dapat mengubah nama file nanti, tetapi kompatibilitas akan dipertahankan.

Pembuat paket suara kemudian akan menggunakan pemetaan Anda di pengganti mereka. Pemetaan dalam pertandingan ditambahkan dengan a #.

{"penggantian ": [{"cocok": "

Konvensi penamaan

Disarankan untuk mengikuti konvensi penamaan untuk kondisi dan pemetaan Anda. Tidak memiliki 1'bagian' atau lebih dari 3. Setiap bagian harus dipisahkan dengan titik dua.

• Nama mod Anda: nama Atau.
• Nama mod Anda: subkategori: nama