Команды RPG Maker MV/Воспроизвести BGM

Материал из Русская версия РПГ.укр
Окно настройки команды Воспроизвести BGM.

Воспроизвести BGMкоманда событий в RPG Maker MV, позволяющая начать воспроизведение фоновой музыки (BGM) или изменить настройки воспроизводимой музыки.

В каждый момент игры может быть только одна фоновая музыка (BGM). Если команда Воспроизвести BGM вызвана, когда музыка уже проигрывается, то эта команда меняет музыку. Если команда вызвана для того же файла, который уже проигрывается, то меняются только настройки, но файл не сбрасывается на начало.

Особенности звуковых эффектов[править]

Фоновая музыка (BGM) используется для повторяющихся музыкальных звуков, которые:

  • не накладываться друг на друга (в отличие от звуковых эффектов [SE] и фоновых звуков [BGS]): они могут сочетаться только с звуками (SE и BGS), но не с другой музыкой (BGM и ME),
  • звучат постоянно и зацикливаются, повторяются после окончания (в отличие от музыкальных эффектов [ME] и звуковых эффектов [SE]).

Фоновая музыка (BGM) не сочетается с музыкальными эффектами (ME): если воспроизвести музыкальный эффект, то фоновая музыка приостановится на время его воспроизведения.

Доступные настройки[править]

У команды есть такие настройки:

  • Воспроизводимый аудиофайл,
  • Громкость (от 0% до 100%, по умолчанию 90%);
  • Темп (от 50% до 150%);
  • Панорама (от -100 до 100, по умолчанию 0; отрицательные значения сдвигают аудио в левый динамик, а положительные — в правый).

Кнопки «Проиграть» и «Остановить» помогают выбрать нужные настройки в редакторе, но не влияют на саму игру.

Форматы аудиофайлов[править]

Файлы для этой команды располагаются внутри папки проекта, в подпапке audio\bgm.

Все файлы должны быть в двух форматах:

  • OGG Vorbis (.ogg),
  • AAC (.m4a)

Используемый формат зависит от устройства. Для Linux, Windows и macOS используется формат .ogg, поэтому если не планируется экспорт на мобильные устройства, можно ограничиться им.

Технические подробности[править]

Внутренний формат[править]

Внутренний код команды «Воспроизвести BGM» — 241. Команда кодируется таким образом:

{
  "code": 241,
  "indent": степень_вложенности,
  "parameters": [
    {
      "name": "имя_файла_без_расширения",
      "volume": громкость,
      "pitch": темп,
      "pan": панорама
    }
  ]
}

Где:

  • вместо степень_вложенности ставится количество команд, в которые вложена данная команда,
  • вместо "имя_файла_без_расширения" ставится имя файла без расширения в кавычках,
  • вместо громкость ставится число от 0 до 100,
  • вместо темп ставится число от 50 до 150,
  • вместо панорама ставится число от -100 до 100.

Использование в JavaScript[править]

Чтобы установить фоновую музыку (BGM) в коде на JavaScript, можно использовать такой код:

AudioManager.playBgm({
  "name": "Theme2", //вместо Theme2 нужно поставить имя файла без расширения
  "volume": 70, //вместо 70 нужно поставить громкость от 0 до 100
  "pitch": 100, //вместо 100 нужно поставить темп от 50 до 150
  "pan": 0 //вместо 0 нужно поставить сдвиг влево/вправо от -100 до 100
});