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

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

Воспроизвести SEкоманда событий в RPG Maker MV, позволяющая воспроизвести звуковой эффект. Команда только начинает воспроизведение звукового эффекта: оно закончится уже во время выполнения других команд.

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

Звуковые эффекты (SE) используются для немузыкальных звуков, которые:

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

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

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

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

В окне настройки также есть кнопки «Проиграть» и «Остановить», которые позволяют прослушивать звуковой эффект в редакторе (и останавливать проигрывание). Они никак не влияют на игру, а лишь позволяют определить, правильно ли выбраны настройки.

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

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

Для поддержки кроссплатформенности все файлы должны быть в двух форматах: OGG Vorbis (.ogg) и AAC (.m4a). Каждый файл должен быть доступен в двух форматах, так как разные форматы используются на разных платформах: OGG Vorbis (ogg) используется на компьютерах под управлением Linux, Windows и macOS, а AAC m4a используется на некоторых мобильных устройствах.

Если необходима работа только на обычных компьютерах, достаточно файлов в формате OGG Vorbis (ogg).

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

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

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

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

Где:

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

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

Для начала воспроизведения звукового эффекта (SE) можно использовать такой код на JavaScript:

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

См. также[править]