Добавление звуков в модуль



Аудиосистема Bannerlord построена на фирменной аудиосистеме FMOD. Чтобы сохранить производительность звукового движка и сделать его доступным для всех, нам нужно было создать свой внутриигровой аудиопроигрыватель.

Ключевые элементы
  • В файл  ...\Modules\*ВАШ МОД*\ModuleData\module_sounds.xml вы прописываете названия своих звуковых файлов. В папку  ...\Modules\*ВАШ МОД*\ModuleSounds вы помещаете свои новые аудиофайлы (.ogg, .wav).

В качестве примера можно посмотреть, как это реализовано у разработчиков в их модуле ‘Native’.


Базовое руководство

1. Скопируйте примеры файлов и папок из модуля ‘Native’в свой собственный модуль.
2. Добавьте свои новые звуки в папку ModuleSounds
3. Откройте файл module_sounds.xml в вашем модуле.
4. Просмотрите пример записи кода звуковых файлов в файле module_sounds.xml  модуля ‘Native’.
5. Добавьте новые строки в файл module_sounds.xml своего мода.
6. Воспроизведите для проверки новое звуковые записи из кода.


Двигаемся дальше

Using module_sounds.xml (Помощь в создании файла module_sounds.xml):
    <module_sound name="example/combat/hit" is_2d="true" sound_category="mission_combat" path="example_sound_modders.ogg" />
, где:

‘name’: любое уникальное имя, которое вы хотите. Это идентификатор вашего звука.
  • Используется во время воспроизведения звука из кода.
  • Используется для воспроизведения звука анимации, добавив к анимации свойство 'sound_code'.

‘is_2d’: (Звук является двухмерным "2D") Ставится значение "true" (верно), если пространственные свойства звука не будут использоваться. 3d звуки имеют свойства, как (position) расположение в пространстве, (velocity) скорость воспроизведения и т.д.

‘sound_category’: Все звуки должны быть отнесены к определенной категории, чтобы они правильно воспроизводились.
Доступные категории:
НАЗВАНИЕ
ОПИСАНИЕ
ПРИМЕР
mission_ambient_bed
Двухмерные, зацикленные звуки окружения
Ветер, другие погодные явления
mission_ambient_3d_big
Звуки, которые должны быть слышны издалека
Горящий замок
mission_ambient_3d_medium
Звуки, которые должны быть слышны со среднего расстояния
Костры
mission_ambient_3d_small
Звуки, которые должны быть слышны поблизости
Костры в лагере
mission_material_impact
Звуки физических материальных воздействий
Удар металлического меча о каменную стену
mission_combat_trivial
Слабые звуки урона в сражениях
Звук при получении низкого урона или вообще без урона
mission_combat
Звуки урона в сражениях
Звук при получении стандартного или критического урона
mission_foley
Различные шумовые эффекты (фоли)
Взмахи оружия, звук шагов, звуки движения животных
mission_voice_shout
Крики людей/животных, которые должны быть слышны издалека
Боевые крики
mission_voice
Звуки людей/животных
Хрюканье, удары по лицу
mission_voice_trivial
Слабые звуки людей/животных
Лазание, прыжки
mission_siege_loud
Громкие звуки осады
Валун, врезающийся в стену, стрельба катапульты, разрушение двери
mission_footstep
Стандартные шаги
Шаги одиночных людей и мелких животных
mission_footstep_run
Более громкие шаги, которые можно услышать издалека
Бег, или движение толпы
mission_horse_gallop
Громкие звуки движения ездовых животных
Галоп лошадей и верблюдов
mission_horse_walk
Стандартные звуки движения ездовых животных
Мягкий шаг лошадей и верблюдов
ui
Двухмерные звуки для пользовательского интерфейса и уведомлений
Звук нажатия на кнопку, при всплывающем уведомлении, и т.д.
alert
Псевдо-3d звуки для оповещения игрока со средней дистанции

campaign_node
Позиционные звуки для глобальной карты
Звуки ферм, морей, водопадов
campaign_bed
Двухмерные звуки окружения для глобальной карты
Порывы ветра в пустыне, ветры на травяных пастбищах и т.д.

‘path’: Имя звукового файла для воспроизведения [обязательно с его расширением]. Путь (Path) указывается относительно папки ModuleSounds вашего модуля. Вы можете создавать подпапки.

Пример кода в звуковом файле

    int soundIndex = SoundEvent.GetEventIdFromString("example/voice/charge"); //to avoid string operations in runtime soundIndex can be cached.
    if (playOneshot)
    {
        MakeSound(soundIndex, MainAgent.Position, false, true, -1, -1); //plays one shot sound at position with given parameters.
    }
    else
    {
        SoundEvent eventRef = SoundEvent.CreateEvent(soundIndex, Scene); //get a reference to sound and update parameters later.
        eventRef.SetPosition(MainAgent.Position);
        eventRef.Play();
    }


У вас есть два способа воспроизведения звука:
  • One Shot (Один выстрел). Лучшая производительность и меньше контроля за управлением. Выстрелил и забыл. Хорошо подходит для звуков, связанных с боем.
  • Creating and holding (Создание и удержание ссылки). Худшая производительность. Контролируйте каждый параметр звука всякий раз, когда вы хотите его произвести. Обновление состояния во время паузы.




- используйте эту кнопку если вы обнаружили ошибку/искажение содержимого/отсутствие контента в новости или если хотите сообщить администрации о выходе новой версии мода и т.п.

Комментариев 0

Информация
Посетители, находящиеся в группе Гости, не могут оставлять комментарии к данной публикации.

Онлайн

Сейчас на сайте: 82
Гостей: 80

Пользователи: 

Последние комментарии

Mount & Blade - Эпоха турниров (Warband) 1.174
epilect, 8 марта 2025 11:03
Mimo Kakal, Задай вопрос в дискорде,быстрее ответят......
Mount & Blade - Эпоха турниров (Warband) 1.174
Mimo Kakal, 7 марта 2025 11:53
Добрый день, понимаю что очень тупой вопрос, но подскажите пожалуйста как устанавливать мини моды ?...
MOD Honour&Glory (Честь и Слава)
epilect, 6 марта 2025 14:48
Tissimir, Я твоих "котиков" регулярно в другом месте вижу)))...
MOD Honour&Glory (Честь и Слава)
Tissimir, 6 марта 2025 13:53
iskanderzp, успіхів! Якщо будуть ще проблеми - обов'язково пиши. epilect, я в этот аккаунт,...
MOD Honour&Glory (Честь и Слава)
epilect, 6 марта 2025 13:31
Tissimir, :...
MOD Honour&Glory (Честь и Слава)
iskanderzp, 6 марта 2025 13:04
Tissimir, Приєднався у Дискорді. Спробую запускати мод через WSE2. ...
MOD Honour&Glory (Честь и Слава)
Tissimir, 6 марта 2025 12:23
iskanderzp, ми вже пофіксили багато багів, багато з них фіксимо прямо зараз. Виліти це проблема...
MOD Honour&Glory (Честь и Слава)
epilect, 5 марта 2025 11:59
А так в тебе сидит моряк)?Ну вообще я онлайн тоже не жаловал,но когда долго болел попробовал Мифы...
MOD Honour&Glory (Честь и Слава)
iskanderzp, 5 марта 2025 11:17
epilect, Друже, если  у тебя есть выход на авторов мода, передай им мое восхищение задумкой и моё...